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}
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}
<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좌표 간 변환 |