Restful API 기반 Toast Maps Route API를 사용하는 방법을 설명 합니다.
Toast Maps Route API를 사용하기 위해서는 appkey 발급이 필요합니다.
http://cloud.toast.com > Console > Maps 상품을 이용 해주세요.
자세한 사항은 Reference를 참고해주세요.
_
API 사용 방법(Java)
Java 기반 서버에서 API 호출 하는 방법을 설명 합니다.
https://api-maps.cloud.toast.com/maps/v1.0/appkeys/{appkey}/{apiName}?{parameters}
import java.net.URI;
import java.util.ArrayList;
import java.util.List;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URLEncodedUtils;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;
public class ApiExample {
public String getSearchApi(String apiName){
String apiUrl = "https://api-maps.cloud.toast.com/maps/v1.0/appkeys/";
// 발급받은 appKey
String appkey = "appKey";
apiUrl = apiUrl + appkey + "/" + apiName;
String result = "";
try{
HttpClient httpclient = new DefaultHttpClient();
// 검색 하고자 하는 파라미터를 세팅(경로탐색 요약 예시)
List params = new ArrayList();
params.add( new BasicNameValuePair( "startX", "169031" ) );
params.add( new BasicNameValuePair( "startY", "517925" ) );
params.add( new BasicNameValuePair( "endX", "323655" ) );
params.add( new BasicNameValuePair( "endY", "243548" ) );
params.add( new BasicNameValuePair( "option", "real_traffic,freeroad_priority" ) );
URI requestUrl = new URI( apiUrl + "?" + URLEncodedUtils.format( params, "UTF-8"));
HttpGet get = new HttpGet(requestUrl);
// API를 호출
HttpResponse response = httpclient.execute(get);
// 정상 호출
if(response.getStatusLine().getStatusCode() == 200){
HttpEntity responseEntity = response.getEntity();
// 결과값 인코딩
result = EntityUtils.toString(responseEntity,"UTF-8");
}
} catch (Exception e) {
System.out.println(e);
}
return result;
}
}
API 사용 방법(javascript)
javascript 기반으로 Ajax 방식으로 API 호출 하는 방법을 설명 합니다.
https://api-maps.cloud.toast.com/maps/v1.0/appkeys/{appkey}/{apiName}?{parameters}
<script type="text/javascript">
function fnSearchApi(apiName){
// Ajax 방식으로 Maps API를 호출 하는 방법을 설명 한다.
$.ajax({
contentType : "application/json;charset=utf-8"
,type: "GET"
,dataType: "json"
, url: "https://api-maps.cloud.toast.com/maps/v1.0/appkeys/{appkey}/" + apiName
// 각 API 별로 정의 된 parameter를 입력 (주소검색 예시)
, data: { startX : 169031, startY : 517925, endX : 323655, endY : 243548, option : real_traffic,freeroad_priority}
, success : function(data) {
// Json 결과값 출력 한다.
console.log(data);
}
});
}
</script>
Maps Route API 목록
Maps Route에서 제공되는 API 목록
API 명 | apiName | 설명 |
---|---|---|
경로 탐색 요약 | routes | 입력한 좌표들에 대한 경로 탐색 결과 요약 정보 |
경로 탐색 상세 | route-details | 입력한 좌표들에 대한 경로 탐색 결과 상세 정보 |