Geocoding API는 지오코딩과 역 지오코딩을 제공하는 서비스입니다. 개의 주소가 있습니다.
<ph type="x-smartling-placeholder">지오코딩은 주소 (예: 상세 주소)를 변환하는 과정입니다. 을 지리적 좌표 (예: 위도 및 경도)로 변환할 수 있으며, 이를 사용하여 마커를 배치할 수 있습니다. 위치를 지정할 수 있습니다.
역 지오코딩은 지리 좌표를 변환하는 과정입니다. 인간이 읽을 수 있는 주소로 변환합니다.
또한 Geocoding API를 사용하여 지정된 장소 ID가 있습니다.
샘플 요청 및 응답
HTTP 인터페이스를 통해 Geocoding API에 액세스합니다. 팔로우 중 은 지오코딩 및 역 지오코딩 요청의 예입니다.
지오코딩 요청 및 응답(위도/경도 검색)
다음 예는 '1600 Amphitheatre'의 위도와 경도를 요청합니다. Parkway, Mountain View, CA'로 시작하고 출력이 JSON 형식이어야 함을 지정합니다.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
웹브라우저에 URL을 입력하여 테스트할 수 있습니다 (이때
YOUR_API_KEY를 실제 API 키로 바꿉니다.
응답에는 이 주소의 위도와 경도가 포함됩니다.
개발자 가이드 보기 자세한 내용은 <ph type="x-smartling-placeholder"></ph> 지오코딩 요청 URL 만들기와 사용 가능한 매개변수 및 응답 이해하기
다음은 JSON 형식의 샘플 지오코딩 응답입니다.
{
"results" : [
{
"address_components" : [
{
"long_name" : "1600",
"short_name" : "1600",
"types" : [ "street_number" ]
},
{
"long_name" : "Amphitheatre Parkway",
"short_name" : "Amphitheatre Pkwy",
"types" : [ "route" ]
},
{
"long_name" : "Mountain View",
"short_name" : "Mountain View",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Santa Clara County",
"short_name" : "Santa Clara County",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "California",
"short_name" : "CA",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
},
{
"long_name" : "94043",
"short_name" : "94043",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
"geometry" : {
"location" : {
"lat" : 37.4267861,
"lng" : -122.0806032
},
"location_type" : "ROOFTOP",
"viewport" : {
"northeast" : {
"lat" : 37.4281350802915,
"lng" : -122.0792542197085
},
"southwest" : {
"lat" : 37.4254371197085,
"lng" : -122.0819521802915
}
}
},
"place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE",
"plus_code" : {
"compound_code" : "CWC8+R3 Mountain View, California, United States",
"global_code" : "849VCWC8+R3"
},
"types" : [ "street_address" ]
}
],
"status" : "OK"
}
역지오코딩 요청 및 응답(주소 검색)
다음 예는 지정된 위도/경도에 해당하는 주소를 요청합니다. 뉴욕 브루클린에 있습니다. 결과를 JSON 형식으로 출력하도록 지정합니다.
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY
웹브라우저에 URL을 입력하여 테스트할 수 있습니다 (이때 ‘YOUR_API_KEY’를 실제 API 키로 바꿉니다. 응답에는 위도 및 경도에 대해 사람이 읽을 수 있는 주소가 포함됩니다. 볼 수 있습니다
개발자 가이드 보기 자세한 내용은 <ph type="x-smartling-placeholder"></ph> 역 지오코딩 요청 URL 만들기와 사용 가능한 매개변수 및 응답 이해하기
다음은 JSON 형식의 샘플 역지오코딩 응답입니다.
{
"plus_code" : {
"compound_code" : "P27Q+MC New York, NY, USA",
"global_code" : "87G8P27Q+MC"
},
"results" : [
{
"address_components" : [
{
"long_name" : "279",
"short_name" : "279",
"types" : [ "street_number" ]
},
{
"long_name" : "Bedford Avenue",
"short_name" : "Bedford Ave",
"types" : [ "route" ]
},
{
"long_name" : "Williamsburg",
"short_name" : "Williamsburg",
"types" : [ "neighborhood", "political" ]
},
{
"long_name" : "Brooklyn",
"short_name" : "Brooklyn",
"types" : [ "political", "sublocality", "sublocality_level_1" ]
},
{
"long_name" : "Kings County",
"short_name" : "Kings County",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "New York",
"short_name" : "NY",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
},
{
"long_name" : "11211",
"short_name" : "11211",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA",
"geometry" : {
"location" : {
"lat" : 40.7142484,
"lng" : -73.9614103
},
"location_type" : "ROOFTOP",
"viewport" : {
"northeast" : {
"lat" : 40.71559738029149,
"lng" : -73.9600613197085
},
"southwest" : {
"lat" : 40.71289941970849,
"lng" : -73.96275928029151
}
}
},
"place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE",
"plus_code" : {
"compound_code" : "P27Q+MC Brooklyn, New York, United States",
"global_code" : "87G8P27Q+MC"
},
"types" : [
"bakery",
"cafe",
"establishment",
"food",
"point_of_interest",
"store"
]
},
... Additional results truncated in this example[] ...
],
"status" : "OK"
}
클라이언트 라이브러리로 코딩 시작하기
클라이언트 라이브러리를 사용하면 Google Maps 웹 서비스 API로 더욱 쉽게 개발할 수 있도록 인증, 요청 처리 등 일반적인 작업의 기본 구현 제한과 자동 재시도입니다 Geocoding API 사용 가능 를 Java 클라이언트 Python 클라이언트, Go 클라이언트, Google 지도 서비스용 Node.js 클라이언트.
인증, 할당량, 가격 책정, 정책
인증
Geocoding API를 사용하려면 먼저 API를 사용 설정해야 합니다. 적절한 사용자 인증 정보를 가져옵니다. 자세한 내용은 Google Maps Platform 시작하기
할당량 및 가격 책정
사용량 및 결제 검토 페이지를 참조하세요.
정책
Geocoding API 사용은 API 정책.
자세히 알아보기
Geocoding API로 더 많은 작업을 할 수 있습니다. 자세한 내용은 <ph type="x-smartling-placeholder"></ph> Geocoding API 개발자 가이드를 참고하세요. 예, 사용 가능한 매개변수, 상태 코드 및 오류 메시지, 기타 세부정보입니다.
Geocoding API 개발자 가이드에서는 Geocoding API 웹 서비스 웹사이트 및 모바일 개발자를 대상으로 합니다. Google Maps Platform 중 하나에서 제공하는 지도 내에서 지오코딩 데이터를 사용하려는 경우 API에 액세스할 수 있습니다