本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 如何使用获取地点 本节包含有关如何使用获取地点 API 的各种操作方法指南和示例。 **Topics** + [ # 如何获取 PlaceId 的结果 ](how-to-get-place-by-id.md) + [ # 如何获取联系人 PlaceId ](how-to-get-contacts-by-place-id.md) + [ # 如何获取 a 的时区 PlaceId ](how-to-get-timezone-by-place-id.md) + [ # 如何获取特定语言 PlaceId 的详细信息 ](how-to-get-place-details-language-place-id.md) + [ # 如何获取地点 ID 的辅助地址 ](how-to-get-secondary-addresses-placeid.md) # 如何获取 PlaceId 的结果 GetPlace API 使用某地点的唯一 PlaceId 来检索有关该地点的详细信息，从而允许应用程序访问有关指定位置的全面详细信息。 ## 潜在使用案例 + **检索存储位置：**使用 PlaceId 获取有关各存储位置的详细信息，以改善用户体验并高效管理资源。 + **获取相关地点详细信息：**获取使用先前查询返回的其他 PlaceId 标识的地点的详细信息。 ## 示例 ### 使用 PlaceId 获取地点 ------ #### [ Sample request ] ``` https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP?key=Your_Key ``` ------ #### [ Sample response ] ``` { "PlaceId": "", "PlaceType": "PointOfInterest", "Title": "London Eye", "Address": { "Label": "London Eye, County Hall, Westminster Bridge Road, London, SE1 7, United Kingdom", "Country": { "Code2": "GB", "Code3": "GBR", "Name": "United Kingdom" }, "Region": { "Name": "England" }, "SubRegion": { "Code": "LDN", "Name": "London" }, "Locality": "London", "District": "Waterloo", "PostalCode": "SE1 7", "Street": "County Hall, Westminster Bridge Road", "StreetComponents": [ { "BaseName": "County Hall, Westminster Bridge Road", "Language": "en-GB" } ] }, "Position": [ -0.11953, 51.50336 ], "Categories": [ { "Id": "tourist_attraction", "Name": "Tourist Attraction", "LocalizedName": "Tourist Attraction", "Primary": true }, { "Id": "landmark-attraction", "Name": "Landmark-Attraction", "LocalizedName": "Landmark-Attraction", "Primary": false }, { "Id": "residential_area-building", "Name": "Residential Area-Building", "LocalizedName": "Residential Area/Building", "Primary": false } ] } ``` ------ #### [ cURL ] ``` curl --request GET \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP?key=Your_Key&language=en' ``` ------ #### [ AWS CLI ] ``` export PLACEID=AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIs aws geo-places get-place --key ${YourKey} --place-id ${PLACEID} ``` ------ # 如何获取联系人 PlaceId **注意** 对于`ap-southeast-1`和中的客户`ap-southeast-5`，由于该`Contacts`字段不可用，因此不支持此用例。有关详细信息，请参阅 [GetPlace API 参考](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_GetPlace.html)。 该 GetPlace API允许检索与特定联系人相关的联系信息 PlaceId，为您提供电话号码和网站等详细信息 URLs。 ## 潜在使用案例 + **获取其他已保存的联系信息 PlaceId：**通过访问联系人数据来增强存储的地点详细信息。 + 通过@@ **自动完成功能检索地址的联系方式：使用自动**补全 API PlaceId 中的来获取特定的联系人详细信息。 ## 示例 ### 获取联系人以获取 PlaceId ------ #### [ Sample request ] ``` https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP?additional-features=Contact&key=Your_Key ``` ------ #### [ Sample response ] ``` { "PlaceId": "AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP", "PlaceType": "PointOfInterest", "Title": "London Eye", "Address": { "Label": "London Eye, County Hall, Westminster Bridge Road, London, SE1 7, United Kingdom", "Country": { "Code2": "GB", "Code3": "GBR", "Name": "United Kingdom" }, "Region": { "Name": "England" }, "SubRegion": { "Code": "LDN", "Name": "London" }, "Locality": "London", "District": "Waterloo", "PostalCode": "SE1 7", "Street": "County Hall, Westminster Bridge Road", "StreetComponents": [ { "BaseName": "County Hall, Westminster Bridge Road", "Language": "en-GB" } ] }, "Position": [ -0.11953, 51.50336 ], "Categories": [ { "Id": "tourist_attraction", "Name": "Tourist Attraction", "LocalizedName": "Tourist Attraction", "Primary": true }, { "Id": "landmark-attraction", "Name": "Landmark-Attraction", "LocalizedName": "Landmark-Attraction", "Primary": false }, { "Id": "residential_area-building", "Name": "Residential Area-Building", "LocalizedName": "Residential Area/Building", "Primary": false } ], "Contacts": { "Phones": [ { "Value": "+44870500600" }, { "Value": "+448709908883" } ], "Websites": [ { "Value": "http://www.londoneye.com" } ] } } ``` ------ #### [ cURL ] ``` curl --request GET \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP?key=Your_Key&additional-features=Contact&language=en' ``` ------ #### [ AWS CLI ] ``` export PLACEID=AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP aws geo-places get-place --key ${YourKey} --place-id ${PLACEID} --additional-features "Contact" --language "en" ``` ------ # 如何获取 a 的时区 PlaceId 该 GetPlace API 允许检索与特定联系人相关的联系信息 PlaceId，为您提供电话号码、时区和网站等详细信息 URLs。 ## 潜在使用案例 + **获取保存的更多时区信息 PlaceId：**使用商店创建世界时钟 PlaceId。 + **从 “自动完成” 中检索地址的时区详细信息:**跟踪夏令时. PlaceId ## 示例 ### 获取 a 的时区 PlaceId ------ #### [ Sample request ] ``` https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP?additional-features=TimeZone&key=Your_Key ``` ------ #### [ Sample response ] ``` { "PlaceId": "", "PlaceType": "PointOfInterest", "Title": "London Eye", "Address": { "Label": "London Eye, County Hall, Westminster Bridge Road, London, SE1 7, United Kingdom", "Country": { "Code2": "GB", "Code3": "GBR", "Name": "United Kingdom" }, "Region": { "Name": "England" }, "SubRegion": { "Code": "LDN", "Name": "London" }, "Locality": "London", "District": "Waterloo", "PostalCode": "SE1 7", "Street": "County Hall, Westminster Bridge Road", "StreetComponents": [ { "BaseName": "County Hall, Westminster Bridge Road", "Language": "en-GB" } ] }, "Position": [ -0.11953, 51.50336 ], "Categories": [ { "Id": "tourist_attraction", "Name": "Tourist Attraction", "LocalizedName": "Tourist Attraction", "Primary": true }, { "Id": "landmark-attraction", "Name": "Landmark-Attraction", "LocalizedName": "Landmark-Attraction", "Primary": false }, { "Id": "residential_area-building", "Name": "Residential Area-Building", "LocalizedName": "Residential Area/Building", "Primary": false } ], "TimeZone": { "Name": "Europe/London", "Offset": "+01:00", "OffsetSeconds": 3600 } } ``` ------ #### [ cURL ] ``` curl --request GET \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP?key=Your_Key&=TimeZone' ``` ------ #### [ AWS CLI ] ``` export PLACEID=AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP aws geo-places get-place --key ${YourKey} \ --place-id ${PLACEID} \ --additional-features "TimeZone" ``` ------ # 如何获取特定语言 PlaceId 的详细信息 该功能允许您从 BCP47符合标准的代码中选择首选的响应语言。它根据名称变体检测查询语言，并使用首选语言处理不匹配的令牌和模棱两可的情况。如果未指定请求的语言，地点 API 提供的结果将使用国家/地区使用的任何语言，但在语言有差异的区域则优先使用当地语言。作为后备方案，当某些地址元素在请求的语言中不可用时，Places 会以默认语言 APIs 返回地址。 ## 潜在使用案例 + **添加 PlaceId 详情：**以指定语言为存储的地点 ID 添加更多详情。 + **从 “自动完成” 中检索地址的 PlaceId 详细信息：**以特定语言获取存储 PlaceId地址的更多详细信息。 ## 示例 ### 获取特定语言 PlaceId 的 a 的详细信息 ------ #### [ Sample request ] ``` https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAY0R_4qfQ9LZ0j6lpOggbNLAQ31TRf-sESER_bKKjCar9FF6A3UA0HrYWa4yfeUN5V0qkk6NmdrI3y7fB7PZ4vfuo-Z8Wd-u-01an4KNvWaqfYmEh14s22yCV9Nb1yMXl4-HTfpX5D-jWQT14FEIBqoiuKwLq?language=EN&key=Your_Key ``` ------ #### [ Sample response ] ``` { "PlaceId": "", "PlaceType": "PointOfInterest", "Title": "Parking Area", "Address": { "Label": "Parking Area, Al Nahda Sharjah, United Arab Emirates", "Country": { "Code2": "AE", "Code3": "ARE", "Name": "United Arab Emirates" }, "SubRegion": { "Name": "Sharjah" }, "Locality": "Sharjah", "District": "Al Nahda" }, "Position": [ 55.3733, 25.30388 ], "Categories": [ { "Id": "parking_lot", "Name": "Parking Lot", "LocalizedName": "Parking Lot", "Primary": true } ], "Contacts": { "Phones": [ { "Value": "+971507766189" } ] }, "AccessPoints": [ { "Position": [ 55.37348, 25.30398 ] } ] } ``` ------ #### [ cURL ] ``` curl --request GET \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAY0R_4qfQ9LZ0j6lpOggbNLAQ31TRf-sESER_bKKjCar9FF6A3UA0HrYWa4yfeUN5V0qkk6NmdrI3y7fB7PZ4vfuo-Z8Wd-u-01an4KNvWaqfYmEh14s22yCV9Nb1yMXl4-HTfpX5D-jWQT14FEIBqoiuKwLq?language=EN&key=Your_Key` ``` ------ #### [ AWS CLI ] ``` export PLACEID=AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP aws geo-places get-place --key ${YourKey} \ --place-id ${PLACEID} \ --language "en" ``` ------ # 如何获取地点 ID 的辅助地址 **注意** 对于`ap-southeast-1`和中的客户`ap-southeast-5`，由于该`SecondaryAddresses`字段不可用，因此不支持此用例。有关详细信息，请参阅 [GetPlace API 参考](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_GetPlace.html)。 `SecondaryAddresses` API 命令允许您检索主地址下的所有辅助地址。地理编码还会返回 `QueryText` 参数中存在的任何辅助单元。 ## 潜在使用案例 **检索主地址下的所有辅助地址。**这可用于填写地址表使用案例，以选择更准确的辅助地址，其中还包含更准确的位置信息。 ## 获取地点 ID 的辅助地址 ------ #### [ Sample request ] ``` https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAGAAY8Dw_tn6pyN_R5E9_mfwAP5h9Rd5E_xY2CyyRHpX2wolGeK8O3IY13k5xeHmF4To445fCLg0x3GPnTZnCuUWXbfg9SKpijUskj-xf6jNC_3CUSabHVKy-Or51xHTd3KNi6idTkrfeQOjZOkXZ5TaoXsg0GHGMWqs-sZhmr8npQc?additional-features=SecondaryAddresses&key=Your_Key ``` ------ #### [ Sample response ] ``` { "PlaceId": "", "PlaceType": "PointAddress", "Title": "910 Beach Ave, Vancouver, BC V6Z 2W7, Canada", "Address": { "Label": "910 Beach Ave, Vancouver, BC V6Z 2W7, Canada", "Country": { "Code2": "CA", "Code3": "CAN", "Name": "Canada" }, "Region": { "Code": "BC", "Name": "British Columbia" }, "SubRegion": { "Name": "Metro Vancouver" }, "Locality": "Vancouver", "District": "Downtown Vancouver", "PostalCode": "V6Z 2W7", "Street": "Beach Ave", "StreetComponents": [ { "BaseName": "Beach", "Type": "Ave", "TypePlacement": "AfterBaseName", "TypeSeparator": " ", "Language": "en" } ], "AddressNumber": "910" }, "Position": [ -123.13325, 49.27542 ], "MapView": [ -123.13377, 49.2741, -123.13087, 49.27599 ], "SecondaryAddresses": [ { "PlaceId": "", "PlaceType": "SecondaryAddress", "Title": "101-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada", "Address": { "Label": "101-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada", "SecondaryAddressComponents": [ { "Number": "101" } ] }, "Position": [ -123.1334, 49.27532 ] }, { "PlaceId": "", "PlaceType": "SecondaryAddress", "Title": "102-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada", "Address": { "Label": "102-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada", "SecondaryAddressComponents": [ { "Number": "102" } ] }, "Position": [ -123.1334, 49.27532 ] }, ... ] } ``` ------ #### [ cURL ] ``` curl ‐‐request GET \ ‐‐url 'https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAGAAY8Dw_tn6pyN_R5E9_mfwAP5h9Rd5E_xY2CyyRHpX2wolGeK8O3IY13k5xeHmF4To445fCLg0x3GPnTZnCuUWXbfg9SKpijUskj-xf6jNC_3CUSabHVKy-Or51xHTd3KNi6idTkrfeQOjZOkXZ5TaoXsg0GHGMWqs-sZhmr8npQc?key=Your_Key&additional-features=SecondaryAddresses' ``` ------ #### [ AWS CLI ] ``` export PLACEID=AQAAAGAAY8Dw_tn6pyN_R5E9_mfwAP5h9Rd5E_xY2CyyRHpX2wolGeK8O3IY13k5xeHmF4To445fCLg0x3GPnTZnCuUWXbfg9SKpijUskj-xf6jNC_3CUSabHVKy-Or51xHTd3KNi6idTkrfeQOjZOkXZ5TaoXsg0GHGMWqs-sZhmr8npQc aws geo-places get-place ‐‐key ${YourKey} \ ‐‐place-id ${PLACEID} \ ‐‐additional-features "SecondaryAddresses" ``` ------