Destination là một địa điểm yêu thích hoặc một vị trí cụ thể mà người dùng dự định đến hoặc di chuyển đến. Destination có thể bao gồm những thông tin như điểm điều hướng, địa danh, lối vào và đường viền của toà nhà.
Điểm cuối SearchDestinations của Geocoding API cho phép bạn truy xuất thông tin chi tiết về nhiều đích đến dựa trên các tiêu chí đầu vào khác nhau, chẳng hạn như địa chỉ, mã địa điểm hoặc toạ độ vĩ độ và kinh độ.
Yêu cầu tìm kiếm điểm đến
Yêu cầu tìm kiếm điểm đến là một yêu cầu HTTP POST đến một URL có dạng:
https://geocode.googleapis.com/v4beta/geocode/destinations
Truyền tất cả các tham số trong nội dung yêu cầu JSON hoặc trong tiêu đề như một phần của yêu cầu POST. Ví dụ:
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
Bạn có thể chỉ định vị trí để tìm kiếm một đích đến theo một trong 3 cách:
- Địa chỉ
- Mã địa điểm
- Vĩ độ và kinh độ
Tìm kiếm điểm đến theo địa chỉ
Bạn có thể chỉ định địa chỉ dưới dạng một chuỗi không có cấu trúc. Tính năng mã hoá địa lý theo địa chỉ không phân giải toạ độ vĩ độ và kinh độ hoặc các chuỗi không có cấu trúc khác không biểu thị một địa chỉ. Các yêu cầu sử dụng những chuỗi như vậy không được hỗ trợ và có thể dẫn đến phản hồi lỗi hoặc hành vi không xác định. Sau đây là một số ví dụ về các cụm từ tìm kiếm không được hỗ trợ:
| Loại truy vấn | Ví dụ: |
|---|---|
| Toạ độ vĩ độ và kinh độ. Thay vào đó, hãy sử dụng cụm từ tìm kiếm vị trí. | "37.422131,-122.084801" |
| Có quá nhiều khái niệm hoặc ràng buộc, chẳng hạn như tên của nhiều địa điểm, đường hoặc thành phố trong một cụm từ tìm kiếm | "Market Street San Francisco San Jose Airport" |
| Các phần tử địa chỉ bưu chính không được thể hiện trên Google Maps |
"C/O John Smith 123 Main Street" "P.O. Box 13 San Francisco" |
| Tên của doanh nghiệp, chuỗi cửa hàng hoặc danh mục kết hợp với những vị trí mà các thực thể này không có mặt | "Tesco gần Dallas, Texas" |
| Truy vấn mơ hồ có nhiều cách diễn giải | "Trả lại bộ sạc" |
| Tên cũ không còn được sử dụng nữa | "Middlesex, Vương quốc Anh" |
| Phần tử hoặc ý định không gian địa lý | "Có bao nhiêu chiếc thuyền ở Cảng Ventura?" |
| Tên không chính thức hoặc tên tuỳ chỉnh |
"The Jenga" "The Helter Skelter" |
| Các thực thể chính trị lớn (Thành phố, Tiểu bang, Quốc gia) |
"Thành phố New York" "California" "Hoa Kỳ" |
| Tuyến đường không có địa chỉ cụ thể |
"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
hoặc dưới dạng 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
Bạn thường sử dụng định dạng postalAddress khi xử lý các thành phần địa chỉ được ghi lại trong biểu mẫu HTML.
Tìm kiếm một điểm đến theo mã địa điểm
Bạn có thể truy xuất một đích đến bằng cách cung cấp một mã địa điểm:
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
Mã địa điểm được hỗ trợ
Điểm cuối Search Destinations hoạt động hiệu quả nhất với những Place ID đại diện cho các địa điểm cụ thể, có thể điều hướng.
Mã địa điểm cho các loại như establishment, point_of_interest, premise, street_address và subpremise thường được hỗ trợ.
Chúng tôi không hỗ trợ những mã địa điểm không đại diện cho các vị trí riêng biệt, chẳng hạn như những mã địa điểm được suy luận từ dải địa chỉ (ví dụ: "10-20 Main St"), các đoạn đường không có số cụ thể hoặc mã cộng.
Để đảm bảo khả năng tương thích khi sử dụng tính năng Place Autocomplete để tìm Place ID, hãy cân nhắc việc lọc kết quả theo loại. Bạn có thể sử dụng tham số includedPrimaryTypes trong các yêu cầu Autocomplete để chỉ bao gồm các loại được hỗ trợ nêu trên:
"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]
Điều này đảm bảo rằng các Mã địa điểm do tính năng Place Autocomplete trả về tương thích nhất với phương thức Địa điểm tìm kiếm. Xin lưu ý rằng loại establishment là loại rộng. Mặc dù cần thiết để thu thập nhiều địa điểm của doanh nghiệp, nhưng bộ lọc này cũng có thể bao gồm kết quả của tính năng Place Autocomplete cho các loại natural_feature. Các loại này chỉ có chế độ hỗ trợ hạn chế trong Vị trí xuất hiện trên Tìm kiếm.
Tìm kiếm điểm đến theo vị trí
Bạn có thể tìm kiếm một điểm đến bằng cách cung cấp toạ độ theo vĩ độ và kinh độ:
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
Sử dụng OAuth để đưa ra yêu cầu
Geocoding API phiên bản 4 hỗ trợ OAuth 2.0 để xác thực. Để sử dụng OAuth với Geocoding API, bạn phải chỉ định đúng phạm vi cho mã thông báo OAuth. Geocoding API hỗ trợ các phạm vi sau để sử dụng với điểm cuối Destinations:
https://www.googleapis.com/auth/maps-platform.geocode– Sử dụng với tất cả các điểm cuối của Geocoding API.
Ngoài ra, bạn có thể sử dụng phạm vi https://www.googleapis.com/auth/cloud-platform chung cho tất cả các điểm cuối của Geocoding API. Phạm vi đó hữu ích trong quá trình phát triển nhưng không hữu ích trong quá trình sản xuất, vì đây là một phạm vi chung cho phép truy cập vào tất cả các điểm cuối.
Để biết thêm thông tin và ví dụ, hãy xem phần Sử dụng OAuth.
Phản hồi về điểm đến tìm kiếm
Phản hồi Search Destinations cung cấp ngữ cảnh phong phú, theo từng khu vực cụ thể về vị trí.
Phần này mô tả các trường phản hồi chính. Để biết đầy đủ thông tin chi tiết về tất cả các trường phản hồi, hãy xem Tài liệu tham khảo về API.
primary
Địa điểm chính được xác định bằng cụm từ tìm kiếm trong yêu cầu.
containingPlaces
Các thực thể lớn hơn mà vị trí chính thuộc về (ví dụ: một trung tâm mua sắm có chứa một cửa hàng).
subDestinations
Vị trí cụ thể hơn trong điểm đến chính (ví dụ: căn hộ trong một toà nhà).
entrances
Các đối tượng trong mảng entrances[] có các trường sau:
locationMột cặp toạ độ vĩ độ/kinh độ duy nhất xác định vị trí của một điểm vào và điểm ra của một địa điểm.
entrance_tags[]Một mảng các thẻ lối vào mô tả đặc điểm của lối vào. Giá trị sau đây được hỗ trợ:
"PREFERRED"Cho biết lối vào này có thể giúp bạn tiếp cận được địa điểm được trả về. Một địa điểm có thể có nhiều lối vào ưu tiên. Nếu một lối vào không có thẻ này, tức là lối vào đó nằm trong cùng một toà nhà nhưng không nhất thiết phải có lối vào nơi đó.
Ví dụ: nếu địa điểm được trả về là một nhà hàng trong khu mua sắm, thì các lối vào
"PREFERRED"sẽ là những lối vào dẫn vào chính nhà hàng đó, trong khi các lối vào được trả về khác sẽ là những lối vào khác của toà nhà, chẳng hạn như lối vào các nhà hàng khác trong khu mua sắm.Nếu địa điểm được trả về là một toà nhà, thì các lối vào
"PREFERRED"sẽ là những lối dẫn vào phần "chính" của toà nhà. Ví dụ: trong một trung tâm mua sắm, các lối vào"PREFERRED"sẽ là những lối vào cho phép truy cập vào khu vực sảnh chính, nhưng nếu một lối vào chỉ cho phép truy cập vào một cửa hàng ở bên hông toà nhà, thì đó sẽ không phải là lối vào"PREFERRED".
structureType
Loại cấu trúc mà địa điểm này đại diện.
POINTVị trí điểm.
SECTIONMột phần của toà nhà.
BUILDINGMột toà nhà.
GROUNDSMột khu vực rộng lớn thường có nhiều toà nhà, chẳng hạn như khuôn viên trường đại học, khu chung cư hoặc trung tâm mua sắm.
navigationPoints
Trường navigationPoints trong phản hồi Geocoding chứa danh sách các điểm hữu ích cho việc di chuyển đến địa điểm. Cụ thể, bạn nên sử dụng các điểm này làm điểm bắt đầu hoặc điểm kết thúc khi định tuyến trên mạng lưới đường bộ từ hoặc đến địa điểm. Mỗi điểm điều hướng chứa các giá trị sau:
navigationPointTokenlà một mã thông báo chứa thông tin theo bối cảnh trong trườngnavigationPoints. Bạn có thể gửi mã thông báo này đến các API định tuyến và điều hướng để cải thiện trải nghiệm định tuyến và điều hướng trong ứng dụng của mình. Hãy xem phần Định tuyến bằng mã thông báo điểm điều hướng để biết thêm thông tin.locationchứa giá trị vĩ độ, kinh độ của điểm điều hướng. Vị trí này sẽ luôn rất gần với mạng lưới đường bộ và là điểm dừng hoặc điểm xuất phát lý tưởng để di chuyển đến và đi từ một địa điểm. Điểm này được cố ý đặt lệch một chút so với đường tim của đường để đánh dấu rõ ràng phía đường nơi địa điểm nằm.travelModeslà danh sách các chế độ di chuyển mà điểm điều hướng có thể truy cập được:"DRIVE"là chế độ di chuyển tương ứng với chỉ đường lái xe."WALK"là chế độ di chuyển tương ứng với chỉ đường đi bộ.
usageslà danh sách các cách sử dụng được điểm điều hướng hỗ trợ. Mức sử dụng có thể là:"DROPOFF""PICKUP""PARKING"
arrivalSummary
Thông tin chi tiết dựa trên AI để hỗ trợ việc đến nơi. Xem Bản tóm tắt dựa trên AI.
landmarks
Những địa điểm nổi bật gần đó giúp người dùng hiểu được môi trường xung quanh điểm đến.
Định dạng phản hồi
SearchDestinations trả về một SearchDestinationsResponse ở dạng JSON sau:
{ "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" ] } ] } ] }
Thông số bắt buộc
- Một trong 3 tham số sau đây phải có trong yêu cầu API. Tham số này chỉ định địa chỉ, địa điểm hoặc vị trí để tìm kiếm một đích đến:
addressQuery– địa chỉ cần tìm.place– mã địa điểm của địa điểm cần tìm.locationQuery– toạ độ vĩ độ và kinh độ của vị trí cần tìm.
FieldMask
Chỉ định danh sách các trường cần trả về trong phản hồi bằng cách tạo một mặt nạ trường phản hồi. Truyền mặt nạ trường phản hồi đến phương thức bằng cách sử dụng tham số URL
$fieldshoặcfields, hoặc bằng cách sử dụng tiêu đề HTTPX-Goog-FieldMask. Ví dụ: yêu cầu bên dưới sẽ chỉ trả về các lối vào, điểm điều hướng và mã địa điểm của đích đến chính.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/destinationsKhông có danh sách mặc định về các trường được trả về trong phản hồi. Nếu bạn bỏ qua mặt nạ trường, phương thức này sẽ trả về lỗi. Đặt mặt nạ trường thành
*để trả về tất cả các trường. Hãy xem phần Chọn các trường cần trả về để biết thêm thông tin chi tiết.
Thông số tùy chọn
-
travelModes
Chỉ định những loại
navigationPointscần trả về. Các điểm điều hướng cho các phương thức di chuyển khác sẽ bị lọc bỏ. Nếu bạn không đặttravelModes, thì hệ thống có thể trả về các điểm điều hướng của tất cả phương tiện đi lại. languageCode
Ngôn ngữ mà bạn muốn nhận kết quả.
- Xem danh sách ngôn ngữ được hỗ trợ. Google thường xuyên cập nhật các ngôn ngữ được hỗ trợ, vì vậy, danh sách này có thể chưa đầy đủ.
-
Nếu bạn không cung cấp
languageCode, API sẽ mặc định làen. Nếu bạn chỉ định một mã ngôn ngữ không hợp lệ, API sẽ trả về lỗiINVALID_ARGUMENT. - API này cố gắng cung cấp một địa chỉ đường phố mà cả người dùng và người dân địa phương đều có thể đọc được. Để đạt được mục tiêu đó, phương thức này sẽ trả về địa chỉ đường phố bằng ngôn ngữ địa phương, được chuyển tự sang một kịch bản mà người dùng có thể đọc được (nếu cần), tuân theo ngôn ngữ ưu tiên. Tất cả các địa chỉ khác đều được trả về bằng ngôn ngữ ưu tiên. Tất cả các thành phần địa chỉ đều được trả về bằng cùng một ngôn ngữ, được chọn từ thành phần đầu tiên.
- Nếu không có tên bằng ngôn ngữ ưu tiên, API sẽ sử dụng kết quả trùng khớp gần nhất.
- Ngôn ngữ ưu tiên có ảnh hưởng nhỏ đến tập hợp kết quả mà API chọn trả về và thứ tự trả về. Trình mã hoá địa lý diễn giải các từ viết tắt theo nhiều cách tuỳ thuộc vào ngôn ngữ, chẳng hạn như từ viết tắt cho các loại đường phố hoặc từ đồng nghĩa có thể hợp lệ trong một ngôn ngữ nhưng không hợp lệ trong ngôn ngữ khác.
regionCode
Mã khu vực dưới dạng giá trị mã CLDR gồm 2 ký tự. Không có giá trị mặc định. Hầu hết mã CLDR đều giống với mã ISO 3166-1.
Khi mã hoá địa lý một địa chỉ, mã hoá địa lý xuôi, tham số này có thể ảnh hưởng nhưng không hoàn toàn hạn chế kết quả từ dịch vụ đối với khu vực được chỉ định. Khi mã hoá địa lý một vị trí hoặc một địa điểm, mã hoá địa lý ngược hoặc mã hoá địa lý địa điểm, bạn có thể dùng tham số này để định dạng địa chỉ. Trong mọi trường hợp, tham số này có thể ảnh hưởng đến kết quả dựa trên luật hiện hành.
-
placeFilter
Cho phép bạn lọc kết quả của một cụm từ tìm kiếm
locationQueryđể đáp ứng các yêu cầu của bạn, chẳng hạn như chỉ trả về những đích đến là toà nhà hoặc chỉ trả về những đích đến có địa chỉ rõ ràng.Lọc theo mức độ chi tiết về cấu trúc
Bộ lọc
structureTypecho phép bạn chỉ định loại cấu trúc mà truy vấn trả về:- Tách biệt các toà nhà: Sử dụng
"structureType": "BUILDING"để hiện đường viền của toà nhà trên bản đồ hoặc xem thông tin chi tiết về một cấu trúc cụ thể. - Tìm hiểu về các khu phức hợp: Sử dụng
"structureType": "GROUNDS"để đảm bảo kết quả chính là toàn bộ khuôn viên. Điều này hữu ích khi truy vấn các khu vực lớn hơn như khuôn viên trường đại học hoặc trung tâm mua sắm. - Tập trung vào các đơn vị/phần: Sử dụng
"structureType": "SECTION"để xác định các phần trong một toà nhà.
Đảm bảo địa chỉ hữu ích
Không phải địa điểm nào cũng có địa chỉ rõ ràng ở cấp đường. Bộ lọc
addressabilitygiúp bạn kiểm soát chất lượng của địa chỉ trong kết quả:- Yêu cầu địa chỉ chính rõ ràng: Để đảm bảo kết quả đích đến chính luôn có địa chỉ hoặc tên ở cấp đường, hãy sử dụng
"addressability": "PRIMARY". Điều này hữu ích cho mục đích điều hướng hoặc hiển thị khi địa chỉ rõ ràng là yếu tố quan trọng. - Cho phép địa chỉ trong các vị trí phụ: Trong trường hợp vị trí chính có thể không có địa chỉ, nhưng các đơn vị trong vị trí đó có địa chỉ (chẳng hạn như các căn hộ trong một toà nhà),
"addressability": "WEAK"đảm bảo rằng ít nhất vị trí chính hoặc một trong các vị trí phụ của vị trí đó có địa chỉ. - Mọi kết quả: Nếu sự hiện diện của địa chỉ không liên quan đến trường hợp sử dụng của bạn, hãy dùng
"addressability": "ANY".
Ví dụ: Lọc các toà nhà có địa chỉ
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 - Tách biệt các toà nhà: Sử dụng
Phản hồi
Đây là một điểm cuối thử nghiệm của Geocoding API. Chúng tôi rất mong nhận được ý kiến phản hồi tại địa chỉ geocoding-feedback-channel@google.com.