주소 설명어는 랜드마크와 지역을 사용하여 위도와 경도 좌표를 설명하는 데 도움이 되는 표준 역 지오코딩 응답에 추가 정보를 반환합니다. 주소 설명어 데모를 확인하여 API를 살펴보세요.
역 지오코딩 요청 - 추가 매개변수
선택적 매개변수
다음은 역 지오코딩 요청에 포함할 수 있는 선택적 매개변수입니다.
역 지오코딩의 예
다음 쿼리에는 델리에 있는 위치의 위도/경도 값이 포함됩니다.
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&key=YOUR_API_KEY&enable_address_descriptor=true
응답
위 쿼리는 다음과 같이 추가 address_descriptor
를 반환합니다.
{
"address_descriptor" : {
"areas" : [
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Turkman Gate"
},
"place_id" : "ChIJ_7LLvyb9DDkRMKKxP9YyXgs"
},
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Chandni Chowk"
},
"place_id" : "ChIJWcXciBr9DDkRUb4dCDykTwI"
},
{
"containment" : "NEAR",
"display_name" : {
"language_code" : "en",
"text" : "Katar Ganj"
},
"place_id" : "ChIJH3cWUyH9DDkRaw-9CjvcRvY"
}
],
"landmarks" : [
{
"display_name" : {
"language_code" : "en",
"text" : "Delite Cinema"
},
"straight_line_distance_meters" : 29.9306755065918,
"place_id" : "ChIJLfiYDCT9DDkROoEa7NdupUM",
"travel_distance_meters" : 418.7794799804688,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "establishment", "movie_theater", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "YES Bank"
},
"straight_line_distance_meters" : 66.83731079101562,
"place_id" : "ChIJFYHM3yb9DDkRRKGkZl2mpSQ",
"travel_distance_meters" : 489.0340270996094,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "UCO Bank"
},
"straight_line_distance_meters" : 25.38849639892578,
"place_id" : "ChIJ-c6_wCb9DDkRjIk1LeqRtGM",
"travel_distance_meters" : 403.2246398925781,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "atm", "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Delhi By Cycle Meeting Point"
},
"straight_line_distance_meters" : 44.02867126464844,
"place_id" : "ChIJNxVfkSb9DDkRJD22l-eGFdM",
"travel_distance_meters" : 97.41281890869141,
"spatial_relationship" : "AROUND_THE_CORNER",
"types" : [
"establishment",
"point_of_interest",
"tourist_attraction",
"travel_agency"
]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Axis Bank Branch"
},
"straight_line_distance_meters" : 102.3495178222656,
"place_id" : "ChIJr3uaDCT9DDkR8roHTVSn1x4",
"travel_distance_meters" : 330.8566284179688,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
}
]
},
... Results (reverse geocoding response) ...
각 address_descriptor
객체에는 landmarks
및 areas
의 두 배열이 있습니다. landmarks
배열에는 요청된 좌표와의 근접성, 랜드마크의 존재 여부, 가시성을 고려하여 관련성순으로 순위가 매겨진 결과가 최대 5개까지 포함됩니다. 각 랜드마크 결과에는 다음 값이 포함됩니다.
place_id
는 명소 결과의 장소 ID입니다. 장소 ID 개요를 참고하세요.display_name
은 랜드마크의 표시 이름이며language_code
및text
를 포함합니다.straight_line_distance_meters
는 입력 좌표와 랜드마크 결과 사이의 지점 간 거리(미터)입니다.travel_distance_meters
는 입력 좌표와 랜드마크 결과 사이의 도로망(도로 제한 무시)을 통해 이동한 거리입니다(미터 단위).spatial_relationship
는 입력 좌표와 랜드마크 결과 간의 추정 관계입니다."NEAR"
는 다음 중 어느 것도 적용되지 않는 경우 기본 관계입니다.- 입력 좌표가 랜드마크와 연결된 구조의 경계 내에 포함된 경우
"WITHIN"
입니다. "BESIDE"
: 입력 좌표가 랜드마크 또는 랜드마크의 액세스 포인트에 직접 인접한 경우."ACROSS_THE_ROAD"
: 입력 좌표가 경로의 반대편에 있는 랜드마크의 정반대에 있을 경우- 입력 좌표가 랜드마크와 동일한 경로를 따라 있지만
"BESIDES"
또는"ACROSS_THE_ROAD"
가 아닌 경우"DOWN_THE_ROAD"
입니다. - 입력 좌표가 랜드마크로 수직 경로를 따라 있을 때
"AROUND_THE_CORNER"
입니다 (한 번 회전으로 제한됨). "BEHIND"
: 입력 좌표가 랜드마크와 공간적으로 가깝지만 액세스 포인트에서는 멀리 떨어져 있는 경우types
는 명소의 장소 유형입니다.
areas
객체는 최대 3개의 응답을 포함하며 인근 지역, 하위 지역, 대규모 복합 단지와 같은 작은 지역을 나타내는 장소로 제한됩니다. 요청된 좌표가 포함된 영역이 먼저 나열되며 가장 작은 영역부터 가장 큰 좌표 순으로 나열됩니다. 각 areas
결과에는 다음 값이 포함됩니다.
place_id
는 지역 결과의 장소 ID입니다. 장소 ID 개요를 참고하세요.display_name
은 영역의 표시 이름이며language_code
과text
를 포함합니다.containment
는 입력 좌표와 영역 결과 간의 예상 포함 관계입니다."NEAR"
는 다음 중 어느 것도 적용되지 않는 경우 기본 관계입니다."WITHIN"
: 입력 좌표가 영역의 중심에 가까울 때"OUTSKIRTS"
: 입력 좌표가 영역의 가장자리에 가까울 때
범위
이 기능은 일부 국가에서만 사용할 수 있습니다.
의견
이 기능은 실험용 기능이며 의견을 보내주시기 바랍니다. address-descriptors-feedback@google.com으로 이메일을 보내주세요.