A
Destination
는 사용자가 도달하거나 탐색하려는 특정 위치 또는 장소를 나타냅니다. Destination에는 탐색 지점, 랜드마크, 입구, 건물 윤곽선과 같이 위치 또는 장소와 관련된 정보 모음도 포함됩니다.
Geocoding API의
SearchDestinations
메서드를 사용하면 주소, 장소 ID, 위도 및 경도 좌표와 같은 다양한
입력 기준에 따라 여러
목적지에 관한 세부정보를 검색할 수 있습니다.
목적지 검색 요청
목적지 검색 요청 은 다음과 같은 형식의 URL에 대한 HTTP POST 요청입니다.
https://geocode.googleapis.com/v4/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/v4/geocode/destinations
다음 세 가지 방법 중 하나로 목적지를 검색할 위치를 지정할 수 있습니다.
- 주소
- 장소 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 near Dallas, Texas" |
| 해석이 여러 가지인 모호한 쿼리 | "Charger drop-off" |
| 더 이상 사용되지 않는 이전 이름 | "Middlesex United Kingdom" |
| 비지리공간 요소 또는 인텐트 | "How many boats are in Ventura Harbor?" |
| 비공식 이름 또는 허영심 이름 |
"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/v4/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/v4/geocode/destinations
일반적으로 HTML 양식에서 캡처된 주소 구성요소를 처리할 때 postalAddress 형식을 사용합니다.
장소 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/v4/geocode/destinations
지원되는 장소 ID
목적지 검색 메서드는 탐색 가능한 특정 목적지를 나타내는 장소 ID에서 가장 잘 작동합니다. 일반적으로 establishment,
point_of_interest, premise, street_address, subpremise와 같은 유형의 장소 ID가
지원됩니다. 주소 범위에서 추론된 장소 ID (예: '10-20 Main St'), 특정 번호가 없는 경로 섹션 또는 플러스 코드와 같이 개별 위치를 나타내지 않는 장소 ID는 지원되지 않습니다. 영역이 너무 큰 결과의 장소 ID (예: '태평양')도 지원되지 않습니다.
목적지 검색에 Places API Autocomplete (신규) 사용
호환성을 보장하려면 Places API Autocomplete
(신규)를 사용하여 목적지 검색에 사용할 장소
ID를 찾으세요. 자동 완성을 사용할 때는
결과를 유형별로 필터링해야 합니다.
includedPrimaryTypes
매개변수를 사용하세요. 다음 권장 필터를 사용하여 자동 완성에서 반환된 장소 ID는 목적지 검색에서 지원됩니다.
"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]
또한 자동 완성 요청에서 include_pure_service_area_businesses
플래그를 true로 설정하면 안 됩니다.
위치로 목적지 검색
위도 및 경도 좌표를 제공하여 목적지를 검색할 수 있습니다.
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/v4/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 범위를 사용할 수 있습니다. 이 범위는 모든 메서드에 대한 액세스를 허용하는 일반 범위이므로 개발 중에는 유용하지만 프로덕션에는 유용하지 않습니다.
자세한 내용과 예는 Use OAuth 사용을 참고하세요.
목적지 검색 응답
목적지 검색 응답은 위치에 관한 풍부한 세부 지역의 컨텍스트를 제공합니다.
목적지 검색 응답 내의 PlaceView 객체 (예: primary, containingPlaces의 항목, landmarks)는 필드를 사용하여 장소 유형을 나타냅니다.
types: 장소의 유형을 나타내는 문자열 배열입니다.primaryType: 장소의 기본 유형을 나타내는 문자열입니다.
`types` 및 `primaryType`의 가능한 문자열 값은 장소 유형 (신규) 페이지의 `표 A와 표 B`에서 가져옵니다.
이 섹션에서는 주요 응답 필드를 설명합니다. 모든 응답 필드에 관한 자세한 내용은 API 참조를 확인하세요.
primary
요청의 쿼리로 식별된 기본 장소입니다.
containingPlaces
기본 목적지가 속한 더 큰 항목입니다 (예: 상점이 있는 쇼핑몰).
subDestinations
기본 목적지 내의 더 구체적인 위치입니다 (예: 건물의 아파트).
entrances
entrances[] 배열의 객체에는 다음 필드가 있습니다.
location장소의 출입구 위치를 정의하는 단일 위도/경도 좌표 쌍입니다.
entrance_tags[]입구의 특성을 설명하는 입구 태그 배열입니다. 다음 값이 지원됩니다.
"PREFERRED"
이 입구는 반환된 장소에 대한 물리적 액세스를 제공할 가능성이 높음을 나타냅니다. 장소에는 여러 개의 선호하는 입구가 있을 수 있습니다. 입구에 이 태그가 없으면 입구가 물리적으로 동일한 건물에 있지만 반드시 장소에 대한 액세스를 제공하지는 않는다는 의미입니다.
예를 들어 반환된 장소가 스트립 몰의 음식점인 경우
"PREFERRED"입구는 음식점 자체로 이어지는 입구이고, 반환된 다른 입구는 스트립 몰의 다른 음식점 입구와 같은 건물의 다른 입구입니다.반환된 장소가 건물 자체인 경우
"PREFERRED"입구는 건물의 "주" 부분으로 이어지는 입구입니다. 예를 들어 쇼핑센터에서"PREFERRED"입구는 주요 로비 구역에 대한 액세스를 허용하는 입구이지만, 입구가 건물 측면의 스토어에 대한 액세스만 제공하는 경우"PREFERRED"입구가 아닙니다.streetViewThumbnail및streetViewAnnotationStreet View Static API의 매개변수로, 이러한 위치에 관한 관련 이미지를 표시할 수 있습니다. 이러한 필드에 관해 자세히 알아보세요.
structureType
이 장소가 나타내는 구조의 유형입니다.
POINT지점 위치입니다.
SECTION건물의 하위 섹션입니다.
BUILDING건물입니다.
GROUNDS일반적으로 대학교 캠퍼스, 아파트 단지 또는 쇼핑몰과 같이 여러 건물이 포함된 넓은 지역입니다.
navigationPoints
지오코딩 응답 내의 navigationPoints 필드에는 장소로 이동하는 데 유용한 지점 목록이 포함되어 있습니다. 특히 장소에서 또는 장소로 도로 네트워크에서 경로를 지정할 때 시작점 또는 끝점으로 사용해야 합니다.
각 탐색 지점에는 다음 값이 포함됩니다.
navigationPointToken은navigationPoints필드의 컨텍스트 정보가 포함된 토큰입니다. 이 토큰을 경로 지정 및 탐색 API로 전송하여 앱에서 경로 지정 및 강 경험을 개선할 수 있습니다. 자세한 내용은 탐색 지점 토큰을 사용하여 경로 지정을 참고하세요.location에는 탐색 지점의 위도, 경도 값이 포함됩니다. 이 위치는 항상 도로 네트워크에 매우 가깝고 장소를 오가는 탐색의 이상적인 정지점 또는 출발지를 나타냅니다. 이 지점은 장소가 있는 도로 측면을 명확하게 표시하기 위해 도로의 중심선에서 약간 벗어나 있습니다.travelModes는 탐색 지점에서 액세스할 수 있는 이동 모드 목록입니다."DRIVE"는 운전 경로에 해당하는 이동 모드입니다."WALK"는 도보 경로에 해당하는 이동 모드입니다.
usages는 탐색 지점에서 지원되는 사용 목록입니다. 사용은 다음과 같습니다."DROPOFF""PICKUP""PARKING"
픽업 및 하차의 경우 이동 모드가 DRIVE이고 사용이 PICKUP 또는 DROPOFF인 탐색 지점을 사용합니다. 승차 또는 하차 지점을 사용할 수 없는 경우 상위 운전 내비게이션 지점을 사용합니다.
streetViewThumbnail및entranceAnnotation은 스트리트 뷰 Static API의 매개변수를 제공하여 이러한 위치에 관한 관련 이미지를 표시할 수 있도록 합니다. 이러한 필드에 관해 자세히 알아보세요.
arrivalSummary
도착을 지원하는 AI 기반 통계입니다. AI 기반 요약을 참고하세요.
landmarks
사용자가 목적지의 주변 환경을 이해하는 데 도움이 되는 주목할 만한 주변 장소입니다.
parkingOptions
자세한 주차 정보입니다.
대답 형식
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" ] } ] } ] }
필수 매개변수
- 다음 세 가지 매개변수 중 하나가 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/v4/geocode/destinations응답에서 반환되는 필드의 기본 목록은 없습니다. 필드 마스크를 생략하면 메서드에서 오류를 반환합니다. 모든 필드를 반환하려면 필드 마스크를
*로 설정하세요. 자세한 내용은 반환할 필드 선택 을 참고하세요.
선택적 매개변수
-
travelModes
반환할
navigationPoints유형을 지정합니다. 다른 이동 모드의 탐색 지점은 필터링으로 제외됩니다. `travelModes`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/v4/geocode/destinations - 건물 격리: 건물
윤곽선을 지도에 표시하거나 특정 구조의 세부정보를 가져오는 데