Toast Maps Search API Guide

Restful API 기반 Toast Maps Search API를 사용하는 방법을 설명 합니다.
Toast Maps Search 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( "query", "판교동" ) );
			params.add( new BasicNameValuePair( "coordtype", "1" ) );
			params.add( new BasicNameValuePair( "startposition", "0" ) );
			params.add( new BasicNameValuePair( "reqcount", "10" ) );
			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: { query : "판교동", coordtype : 0, startposition : 0, reqcount : 1 } 
   	, success : function(data) {
   		// Json 결과값 출력 한다.
   		console.log(data);
   	}
  });
  
 }
 </script>

Maps Search API 목록

  • Maps Search에서 제공되는 API 목록

    API 명 apiName 설명
    주소검색(주소->좌표) coordinates 주소로 좌표를 검색
    좌표검색(좌표->주소) addresses 좌표로 주소를 검색
    통합검색 searches Tel, Address, POI 를 통합적으로 검색
    추천어검색 proposers 검색어의 추천어를 검색
    POI 상세 검색 pois POI들에 대한 상세 정보를 검색
    POI 하위 시설물 검색 sub-pois 해당 POI에 대한 하위 시설물들을 검색
    좌표 변환 trans-coordinates WGS84좌표와 TM좌표 간 변환