Destination은 사용자가 도달하거나 탐색하려는 중요한 관심 장소 또는 특정 위치를 나타냅니다. Destination에는 탐색 지점, 랜드마크, 입구, 건물 개요와 같은 정보가 포함될 수 있습니다.
Geocoding API의 SearchDestinations 엔드포인트를 사용하면 주소, 장소 ID, 위도 및 경도 좌표와 같은 다양한 입력 기준에 따라 여러 대상에 관한 세부정보를 검색할 수 있습니다.
목적지 검색 요청
검색 대상 요청은 다음과 같은 형식의 URL에 대한 HTTP POST 요청입니다.
https://geocode.googleapis.com/v4beta/geocode/destinations
JSON 요청 본문 또는 헤더에서 모든 매개변수를 POST 요청의 일부로 전달합니다. 예를 들면 다음과 같습니다.
curl -X POST -d '{
"place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4beta/geocode/destinations
다음 3가지 방법 중 하나로 목적지를 검색할 위치를 지정할 수 있습니다.
- 주소
- 장소 ID
- 위도 및 경도 좌표
주소로 목적지 검색
주소를 구조화되지 않은 문자열로 지정할 수 있습니다. 주소 지오코딩은 위도 및 경도 좌표 또는 주소를 나타내지 않는 기타 구조화되지 않은 문자열을 확인하지 않습니다. 이러한 문자열을 사용하는 요청은 지원되지 않으며 오류 응답이나 지정되지 않은 동작이 발생할 수 있습니다. 지원되지 않는 질문의 예는 다음과 같습니다.
| 쿼리 유형 | 예 |
|---|---|
| 위도 및 경도 좌표입니다. 대신 위치 쿼리를 사용하세요. | "37.422131,-122.084801" |
| 단일 질문에 여러 장소, 도로 또는 도시의 이름과 같은 개념이나 제약 조건이 너무 많음 | "Market Street San Francisco San Jose Airport" |
| 우편 주소 요소가 Google 지도에 표시되지 않음 |
"C/O John Smith 123 Main Street" "P.O. Box 13 San Francisco" |
| 비즈니스, 체인 또는 카테고리 이름과 이러한 항목을 사용할 수 없는 위치의 조합 | '텍사스주 댈러스 근처의 Tesco' |
| 해석이 여러 개인 모호한 질문 | '충전기 반납' |
| 더 이상 사용되지 않는 이전 이름 | "Middlesex United Kingdom" |
| 지리 공간이 아닌 요소 또는 의도 | "벤투라 항구에 배가 몇 척 있어?" |
| 비공식 이름 또는 허영심을 드러내는 이름 |
"The Jenga" "The Helter Skelter" |
| 대규모 정치적 실체 (도시, 주, 국가) |
"New York City" "California" "USA" |
| 특정 주소가 없는 경로 |
"1st Ave., NYC, NY' 'I-95' |
curl -X POST -d '{
"addressQuery": {
"addressQuery": "601 S Bernardo Ave, Sunnyvale, CA 94087, USA"
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4beta/geocode/destinations
또는 postalAddress로:
curl -X POST -d '{
"addressQuery": {
"address": {
"addressLines": ["601 S Bernardo Ave"],
"locality": "Sunnyvale",
"postalCode": "94087",
"administrativeArea": "CA",
"regionCode": "US"
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4beta/geocode/destinations
일반적으로 HTML 양식에서 캡처된 주소 구성요소를 처리할 때는 postalAddress 형식을 사용합니다.
장소 ID로 목적지 검색
장소 ID를 제공하여 목적지를 검색할 수 있습니다.
curl -X POST -d '{
"place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4beta/geocode/destinations
지원되는 장소 ID
검색 대상 엔드포인트는 탐색 가능한 특정 대상을 나타내는 장소 ID와 함께 사용하는 것이 가장 좋습니다.
establishment, point_of_interest, premise, street_address, subpremise과 같은 유형의 장소 ID는 일반적으로 지원됩니다.
주소 범위 (예: '10-20 Main St'), 특정 번호가 없는 경로 구간 또는 Plus Code에서 추론된 것과 같이 개별 위치를 나타내지 않는 장소 ID는 지원되지 않습니다.
Place Autocomplete를 사용하여 장소 ID를 찾을 때 호환성을 보장하려면 유형별로 결과를 필터링하는 것이 좋습니다. Place Autocomplete 요청에서 includedPrimaryTypes 매개변수를 사용하여 위에 나열된 지원되는 유형만 포함할 수 있습니다.
"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]
이렇게 하면 Place Autocomplete에서 반환된 장소 ID가 Search Destinations 메서드와 가장 호환됩니다. establishment 유형은 광범위합니다. 이 필터는 많은 비즈니스 위치를 캡처하는 데 필요하지만, 검색 대상에서 제한적으로만 지원되는 natural_feature 유형의 Place Autocomplete 결과도 포함될 수 있습니다.
위치로 목적지 검색
위도 및 경도 좌표를 제공하여 목적지를 검색할 수 있습니다.
curl -X POST -d '{
"locationQuery": {
"location": {
"latitude": 37.37348780,
"longitude": -122.05678064
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4beta/geocode/destinations
OAuth를 사용하여 요청하기
Geocoding API v4는 인증에 OAuth 2.0을 지원합니다. Geocoding API와 함께 OAuth를 사용하려면 OAuth 토큰에 올바른 범위가 할당되어야 합니다. Geocoding API는 Destinations 엔드포인트와 함께 사용할 수 있는 다음 범위를 지원합니다.
https://www.googleapis.com/auth/maps-platform.geocode— 모든 Geocoding API 엔드포인트와 함께 사용합니다.
또한 모든 Geocoding API 엔드포인트에 일반 https://www.googleapis.com/auth/cloud-platform 범위를 사용할 수 있습니다. 이 범위는 모든 엔드포인트에 대한 액세스를 허용하는 일반 범위이므로 개발 중에는 유용하지만 프로덕션에서는 유용하지 않습니다.
자세한 내용과 예는 OAuth 사용을 참고하세요.
목적지 검색 응답
검색 대상 응답은 위치에 관한 풍부한 초지역 컨텍스트를 제공합니다.
이 섹션에서는 주요 응답 필드를 설명합니다. 모든 응답 필드에 대한 자세한 내용은 API 참조를 확인하세요.
primary
요청의 쿼리로 식별된 주요 장소입니다.
containingPlaces
기본 도착 페이지가 속한 더 큰 항목입니다 (예: 매장이 포함된 쇼핑몰).
subDestinations
기본 대상 내의 더 구체적인 위치 (예: 건물 내 아파트)
entrances
entrances[] 배열의 객체에는 다음 필드가 있습니다.
location장소의 진입점과 출구 지점을 정의하는 단일 위도/경도 좌표 쌍입니다.
entrance_tags[]입구의 특징을 설명하는 입구 태그의 배열입니다. 다음 값이 지원됩니다.
"PREFERRED"이 출입구가 반환된 장소에 대한 물리적 액세스를 제공할 가능성이 있음을 나타냅니다. 장소에는 기본 출입구가 여러 개 있을 수 있습니다. 출입구에 이 태그가 없으면 출입구가 물리적으로 동일한 건물에 있지만 장소로 연결되지 않을 수 있습니다.
예를 들어 반환된 장소가 쇼핑몰의 음식점인 경우
"PREFERRED"출입구는 음식점 자체로 이어지는 출입구이고, 반환된 다른 출입구는 쇼핑몰의 다른 음식점으로 이어지는 출입구와 같은 건물의 다른 출입구입니다.반환된 장소가 건물 자체인 경우
"PREFERRED"출입구는 건물의 '주' 부분으로 이어지는 출입구입니다. 예를 들어 쇼핑센터에서"PREFERRED"출입구는 메인 로비 구역으로의 액세스를 허용하는 출입구입니다. 하지만 건물 측면에 있는 매장으로만 액세스를 제공하는 출입구는"PREFERRED"출입구가 아닙니다.
structureType
이 장소가 나타내는 구조물의 유형입니다.
POINT포인트 위치입니다.
SECTION건물의 하위 섹션입니다.
BUILDING건물
GROUNDS일반적으로 대학 캠퍼스, 아파트 단지, 쇼핑몰과 같이 여러 건물이 있는 넓은 지역입니다.
navigationPoints
지오코딩 응답 내의 navigationPoints 필드에는 장소로 이동하는 데 유용한 포인트 목록이 포함됩니다. 특히 장소에서 또는 장소로 도로 네트워크에서 경로를 지정할 때 시작점이나 종료점으로 사용해야 합니다. 각 탐색 지점에는 다음 값이 포함됩니다.
navigationPointToken은navigationPoints필드의 컨텍스트 정보를 포함하는 토큰입니다. 이 토큰을 라우팅 및 탐색 API에 전송하여 앱의 라우팅 및 강 경험을 개선할 수 있습니다. 자세한 내용은 탐색 지점 토큰을 사용한 경로 지정을 참고하세요.location에는 탐색 지점의 위도, 경도 값이 포함됩니다. 이 위치는 항상 도로망과 매우 가까우며 장소를 오가는 내비게이션의 이상적인 정지 또는 시작 지점을 나타냅니다. 이 지점은 장소가 있는 도로 측면을 명확하게 표시하기 위해 도로의 중심선에서 의도적으로 약간 오프셋됩니다.travelModes는 탐색 지점에 액세스할 수 있는 이동 수단 목록입니다."DRIVE"은 운전 경로에 해당하는 이동 모드입니다."WALK"은 도보 경로에 해당하는 이동 모드입니다.
usages는 탐색 지점에서 지원하는 사용 목록입니다. 사용은 다음 중 하나일 수 있습니다."DROPOFF""PICKUP""PARKING"
arrivalSummary
도착을 지원하는 AI 기반 유용한 정보 AI 기반 요약을 참고하세요.
landmarks
사용자가 목적지의 주변 환경을 이해하는 데 도움이 되는 주목할 만한 주변 장소
대답 형식
SearchDestinations는 다음 JSON 형식의 SearchDestinationsResponse을 반환합니다.
{ "destinations": [ { "primary": { "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w", "displayName": { "text": "Arby's", "languageCode": "en" }, "primaryType": "fast_food_restaurant", "types": [ "fast_food_restaurant", "sandwich_shop", "deli", "meal_takeaway", "food_delivery", "american_restaurant", "restaurant", "food_store", "store", "food", "point_of_interest", "establishment" ], "formattedAddress": "Arby's, 601 S Bernardo Ave, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "601 S Bernardo Ave" ] }, "structureType": "BUILDING", "location": { "latitude": 37.3734545, "longitude": -122.05693269999998 }, "displayPolygon": { "type": "Polygon", "coordinates": [ [ [ -122.056930138027, 37.3735253692531 ], [ -122.056960139391, 37.3735372663597 ], [ -122.056994129366, 37.3734828786847 ], [ -122.056969677395, 37.3734731161089 ], [ -122.057061762447, 37.3733261309656 ], [ -122.056979388817, 37.3732935577128 ], [ -122.056798860285, 37.3735818838642 ], [ -122.056875858081, 37.3736121235316 ], [ -122.056930138027, 37.3735253692531 ] ] ] } }, "containingPlaces": [ { "place": "places/ChIJYfdAFum2j4ARIcL2tjME3Sw", "displayName": { "text": "Cherry Chase Shopping Center", "languageCode": "en" }, "primaryType": "shopping_mall", "types": [ "shopping_mall", "point_of_interest", "establishment" ], "formattedAddress": "Cherry Chase Shopping Center, 663 S Bernardo Ave, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087-1020", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "663 S Bernardo Ave" ] }, "structureType": "GROUNDS", "location": { "latitude": 37.3731231, "longitude": -122.0578211 }, "displayPolygon": { "type": "Polygon", "coordinates": [ [ [ -122.057112227103, 37.3714618008523 ], [ -122.057076849821, 37.3715743611411 ], [ -122.056963607756, 37.3719081793948 ], [ -122.056865279559, 37.3722026053835 ], [ -122.056687872374, 37.3727258358476 ], [ -122.056580005889, 37.3730511370747 ], [ -122.056498845827, 37.3732994782583 ], [ -122.056338259713, 37.3737878663325 ], [ -122.056618678291, 37.373887693582 ], [ -122.056912102521, 37.3740010327191 ], [ -122.057532418159, 37.3742476426462 ], [ -122.057673926626, 37.3742441740031 ], [ -122.057735663106, 37.3742328516943 ], [ -122.057766531332, 37.3742220604378 ], [ -122.057797572967, 37.37420520725 ], [ -122.057828267759, 37.3741852342085 ], [ -122.058060299297, 37.3740060842535 ], [ -122.058199726081, 37.3737861673422 ], [ -122.05836707267, 37.373524542556 ], [ -122.058569622393, 37.3732018598683 ], [ -122.0587638478, 37.3728890198039 ], [ -122.058934661823, 37.3726036257774 ], [ -122.059164956851, 37.3722498383629 ], [ -122.058997784906, 37.3721804442035 ], [ -122.057936479838, 37.3717605636234 ], [ -122.057495827092, 37.3715860151634 ], [ -122.057112227103, 37.3714618008523 ] ] ] } } ], "landmarks": [ { "place": { "place": "places/ChIJXXTe7Oi2j4ARoMTA-D6Hjpg", "displayName": { "text": "Chase Bank", "languageCode": "en" }, "primaryType": "bank", "types": [ "bank", "atm", "finance", "point_of_interest", "establishment" ], "formattedAddress": "Chase Bank, 1234 W El Camino Real, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "1234 W El Camino Real" ] }, "structureType": "POINT", "location": { "latitude": 37.373579, "longitude": -122.05752700000001 } }, "relationalDescription": { "text": "Near Chase Bank", "languageCode": "en" }, "tags": [ "ARRIVAL", "ADDRESS" ], "straightLineDistanceMeters": 61.182193756103516, "travelDistanceMeters": 63.075645446777344 }, { "place": { "place": "places/ChIJteQ0Fum2j4ARGi3tqK4Zm14", "displayName": { "text": "Safeway", "languageCode": "en" }, "primaryType": "grocery_store", "types": [ "grocery_store", "butcher_shop", "florist", "deli", "supermarket", "bakery", "food_delivery", "market", "manufacturer", "food_store", "store", "food", "service", "point_of_interest", "establishment" ], "formattedAddress": "Safeway, 639 S Bernardo Ave, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "639 S Bernardo Ave" ] }, "structureType": "POINT", "location": { "latitude": 37.3727912, "longitude": -122.0581172 } }, "relationalDescription": { "text": "Around the corner from Safeway", "languageCode": "en" }, "tags": [ "ARRIVAL", "ADDRESS" ], "straightLineDistanceMeters": 158.65606689453125, "travelDistanceMeters": 131.1669921875 }, { "place": { "place": "places/ChIJu-PSYui2j4ARNiwOwBApGqk", "displayName": { "text": "Oil Changers", "languageCode": "en" }, "types": [ "car_repair", "service", "point_of_interest", "establishment" ], "formattedAddress": "Oil Changers, 1240 W El Camino Real, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "1240 W El Camino Real" ] }, "structureType": "POINT", "location": { "latitude": 37.3743054, "longitude": -122.0584272 } }, "relationalDescription": { "text": "Down the road from Oil Changers", "languageCode": "en" }, "tags": [ "ARRIVAL" ], "straightLineDistanceMeters": 140.52459716796875, "travelDistanceMeters": 143.24220275878906 }, { "place": { "place": "places/ChIJKRbl5oG3j4ARwuvPGUmtCj0", "displayName": { "text": "Apni Mandi Farmers Market Sunnyvale", "languageCode": "en" }, "primaryType": "grocery_store", "types": [ "grocery_store", "cake_shop", "supermarket", "asian_grocery_store", "indian_restaurant", "meal_takeaway", "bakery", "manufacturer", "wholesaler", "restaurant", "food_store", "store", "food", "point_of_interest", "establishment" ], "formattedAddress": "Apni Mandi Farmers Market Sunnyvale, 1111 W El Camino Real, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087-1056", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "1111 W El Camino Real" ] }, "structureType": "POINT", "location": { "latitude": 37.3737199, "longitude": -122.0522958 } }, "relationalDescription": { "text": "Near Apni Mandi Farmers Market Sunnyvale", "languageCode": "en" }, "tags": [ "ADDRESS" ], "straightLineDistanceMeters": 410.37435913085938, "travelDistanceMeters": 479.49893188476562 }, { "place": { "place": "places/ChIJ8enMlui2j4AR2xXK5EHDhBs", "displayName": { "text": "Starbird Chicken", "languageCode": "en" }, "primaryType": "chicken_restaurant", "types": [ "chicken_restaurant", "fast_food_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "Starbird Chicken, 1241 W El Camino Real, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087-1028", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "1241 W El Camino Real" ] }, "structureType": "BUILDING", "location": { "latitude": 37.3746764, "longitude": -122.05708860000001 }, "displayPolygon": { "coordinates": [ [ [ -122.057003840785, 37.3747648209809 ], [ -122.057136852459, 37.3747919153144 ], [ -122.057205005705, 37.3745815131859 ], [ -122.057071994114, 37.3745544186944 ], [ -122.057003840785, 37.3747648209809 ] ] ], "type": "Polygon" } }, "relationalDescription": { "text": "Near Starbird Chicken", "languageCode": "en" }, "tags": [ "ADDRESS" ], "straightLineDistanceMeters": 87.348007202148438, "travelDistanceMeters": 214.08084106445312 } ], "entrances": [ { "location": { "latitude": 37.3735328, "longitude": -122.05694879999999 }, "tags": [ "PREFERRED" ], "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w" } ], "navigationPoints": [ { "navigationPointToken": "ChIJeMt61tqvQkARWT2716SDXsASEgljyy_n6LaPgBH9LoGUMNHjbBoSCWPLL-foto-AEf0ugZQw0eNsIhIJhf5y6ei2j4ARz7yBW5KAPI4", "location": { "latitude": 37.3738659, "longitude": -122.05693620000001 }, "travelModes": [ "DRIVE", "WALK" ], "usages": [ "PARKING" ] } ] } ] }
필수 매개변수
- 다음 3개 매개변수 중 하나가 API 요청에 있어야 합니다. 이 매개변수는 목적지를 검색할 주소, 장소 또는 위치를 지정합니다.
addressQuery- 검색할 주소입니다.place- 검색할 장소의 장소 ID입니다.locationQuery- 검색할 위치의 위도 및 경도 좌표입니다.
FieldMask
응답 필드 마스크를 만들어 응답에서 반환할 필드의 목록을 지정합니다. URL 매개변수
$fields또는fields를 사용하거나 HTTP 헤더X-Goog-FieldMask를 사용하여 응답 필드 마스크를 메서드에 전달합니다. 예를 들어 아래 요청은 기본 목적지의 출입구, 탐색 지점, 장소 ID만 반환합니다.curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \ -H "X-Goog-Api-Key: API_KEY" \ -H "Content-Type: application/json" \ -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary.place" \ https://geocode.googleapis.com/v4beta/geocode/destinations응답에 반환된 필드의 기본 목록이 없습니다. 필드 마스크를 생략하면 메서드에서 오류를 반환합니다. 모든 필드를 반환하려면 필드 마스크를
*로 설정합니다. 자세한 내용은 반환할 필드 선택을 참고하세요.
선택적 매개변수
-
travelModes
반환할
navigationPoints유형을 지정합니다. 다른 이동 수단의 탐색 포인트는 필터링으로 제외됩니다.travelModes가 설정되지 않은 경우 모든 이동 수단의 탐색 지점이 반환될 수 있습니다. languageCode
결과를 반환할 언어입니다.
- 지원되는 언어 목록을 참고하세요. Google에서는 지원되는 언어를 자주 업데이트하므로 이 목록에 모든 언어가 포함되지 않을 수도 있습니다.
-
languageCode가 제공되지 않으면 API는 기본적으로en을 사용합니다. 잘못된 언어 코드를 지정하면 API에서INVALID_ARGUMENT오류를 반환합니다. - API는 사용자와 현지인 모두가 읽을 수 있는 상세 주소를 제공하기 위해 최선을 다합니다. 이 목표를 달성하기 위해 선호하는 언어를 준수하여 필요한 경우 사용자가 읽을 수 있는 스크립트로 음역된 현지 언어의 거리 주소를 반환합니다. 다른 모든 주소는 기본 언어로 반환됩니다. 주소 구성요소는 모두 첫 번째 구성요소에서 선택한 동일한 언어로 반환됩니다.
- 선호하는 언어로 이름을 사용할 수 없는 경우 API는 가장 일치하는 이름을 사용합니다.
- 기본 언어는 API가 반환하도록 선택한 결과 집합과 반환되는 순서에 약간의 영향을 미칩니다. 지오코더는 언어에 따라 약어를 다르게 해석합니다. 예를 들어 거리 유형의 약어나 한 언어에서는 유효하지만 다른 언어에서는 유효하지 않은 동의어가 있습니다.
regionCode
두 자리 CLDR 코드 값으로 된 지역 코드입니다. 기본값은 없습니다. 대부분의 CLDR 코드는 ISO 3166-1 코드와 동일합니다.
주소를 지오코딩할 때(순방향 지오코딩) 이 매개변수는 서비스의 결과를 지정된 지역으로 제한하지는 않지만 영향을 줄 수 있습니다. 위치 또는 장소를 지오코딩할 때(역 지오코딩 또는 장소 지오코딩) 이 매개변수를 사용하여 주소 형식을 지정할 수 있습니다. 모든 경우에 이 매개변수는 관련 법규에 따라 결과에 영향을 줄 수 있습니다.
-
placeFilter
locationQuery검색 결과를 필터링하여 건물인 대상만 반환하거나 주소가 명확한 대상만 반환하는 등 요구사항을 충족할 수 있습니다.구조적 세부사항별로 필터링
structureType필터를 사용하면 쿼리에서 반환되는 구조체의 종류를 지정할 수 있습니다.- 건물 격리:
"structureType": "BUILDING"를 사용하여 지도에 건물 윤곽선을 표시하거나 특정 구조물의 세부정보를 확인할 수 있습니다. - 복잡한 내용 이해:
"structureType": "GROUNDS"를 사용하여 기본 결과가 전체 근거가 되도록 합니다. 이 기능은 대학 캠퍼스나 쇼핑몰과 같은 넓은 지역을 쿼리할 때 유용합니다. - 단위/섹션에 집중:
"structureType": "SECTION"를 사용하여 건물 내 섹션을 식별합니다.
유용한 주소 확인
일부 장소에는 명확한 거리 수준 주소가 없습니다.
addressability필터를 사용하면 검색 결과의 주소 품질을 관리할 수 있습니다.- 명확한 기본 주소 필요: 기본 대상 결과에 항상 도로 수준 주소 또는 이름이 표시되도록 하려면
"addressability": "PRIMARY"를 사용하세요. 이는 명확한 주소가 중요한 탐색 또는 표시 목적으로 유용합니다. - 하위 대상의 주소 허용: 기본 장소에 주소가 없지만 그 안에 있는 단위 (예: 건물 내 아파트)에는 주소가 있는 경우
"addressability": "WEAK"는 기본 장소 또는 하위 대상 중 하나에 주소가 있는지 확인합니다. - 결과 없음: 주소 존재 여부가 사용 사례와 관련이 없는 경우
"addressability": "ANY"를 사용합니다.
예: 주소 지정이 가능한 건물 필터링
curl -X POST -d '{ "locationQuery": { "location": { "latitude": 37.37348780, "longitude": -122.05678064 }, "placeFilter": { "structureType": "BUILDING", "addressability": "PRIMARY" } }, "languageCode": "en" }' \\ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \\ -H "X-Goog-FieldMask: place" \\ https://geocode.googleapis.com/v4beta/geocode/destinations - 건물 격리:
의견
이는 Geocoding API의 실험용 엔드포인트입니다. geocoding-feedback-channel@google.com으로 의견을 보내 주시면 감사하겠습니다.