Toast Maps Route API Guide

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}
Sample Code
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}
Sample Code
<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 입력한 좌표들에 대한 경로 탐색 결과 상세 정보