如何使用名称搜索地点、POI 或企业 - Amazon Location Service

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

如何使用名称搜索地点、POI 或企业

该 SearchText API 允许用户使用自由文本输入按名称搜索地点、POI 或企业。可以通过设置偏差位置来细化结果,偏差位置可能基于设备位置、IP 位置或地图视口中心。或者,用户可以提供特定的城市或地点,结果会根据所提供的地理坐标进行偏差。

潜在用例

  • 按名称查找地点:根据地名检索位置,例如 “Gas Town”。

  • 查找兴趣点 (POIs):按名称搜索名胜古迹,例如 “斯坦利公园”。

  • 按企业名称搜索:按名称查找企业,例如 “星巴克”。

示例

Sample request
{ "QueryText": "Gas Town", "BiasPosition": [ -123.11336, 49.26038 ] }
Sample response
{ "ResultItems": [ { "PlaceId": "<Redacted>", "PlaceType": "District", "Title": "Gastown, Vancouver, BC, Canada", "Address": { "Label": "Gastown, Vancouver, BC, Canada", "Country": { "Code2": "CA", "Code3": "CAN", "Name": "Canada" }, "Region": { "Code": "BC", "Name": "British Columbia" }, "SubRegion": { "Name": "Metro Vancouver" }, "Locality": "Vancouver", "District": "Gastown", "PostalCode": "V6B" }, "Position": [ -123.10647, 49.28363 ], "Distance": 2633, "MapView": [ -123.11193, 49.28141, -123.10217, 49.28648 ] } ] }
cURL
curl --request POST \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-text?key=Your_Key' \ --header 'Content-Type: application/json' \ --data '{ "QueryText": "Gas Town", "BiasPosition": [ -123.11336, 49.26038 ] }'
AWS CLI
aws geo-places search-text --key ${YourKey} --query-text "Gas Town" --bias-position -123.11336 49.26038
Sample request
{ "QueryText": "Stanley Park", "BiasPosition": [ -123.11336, 49.26038 ] }
Sample response
{ "ResultItems": [ { "PlaceId": "<Redacted>", "PlaceType": "PointOfInterest", "Title": "Stanley Park", "Address": { "Label": "Stanley Park, Stanley Park Dr, Vancouver, BC V6G, Canada", "Country": { "Code2": "CA", "Code3": "CAN", "Name": "Canada" }, "Region": { "Code": "BC", "Name": "British Columbia" }, "SubRegion": { "Name": "Metro Vancouver" }, "Locality": "Vancouver", "District": "Stanley Park", "PostalCode": "V6G", "Street": "Stanley Park Dr", "StreetComponents": [ { "BaseName": "Stanley Park", "Type": "Dr", "TypePlacement": "AfterBaseName", "TypeSeparator": " ", "Language": "en" } ] }, "Position": [ -123.13593, 49.29716 ], "Distance": 4405, "Categories": [ { "Id": "park-recreation_area", "Name": "Park-Recreation Area", "LocalizedName": "Park-Recreation Area", "Primary": true }, { "Id": "tourist_attraction", "Name": "Tourist Attraction", "LocalizedName": "Tourist Attraction", "Primary": false } ] } ] }
cURL
curl --request POST \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-text?key=Your_Key' \ --header 'Content-Type: application/json' \ --data '{ "QueryText": "Stanley Park", "BiasPosition": [ -123.11336, 49.26038 ] }'
AWS CLI
aws geo-places search-text --key ${YourKey} --query-text "Stanley Park" --bias-position -123.11336 49.26038
Sample request
{ "QueryText": "Amazon YVR11", "BiasPosition": [ -123.11336, 49.26038 ] }
Sample response
{ "ResultItems": [ { "PlaceId": "<Redacted>", "PlaceType": "PointOfInterest", "Title": "Amazon YVR11", "Address": { "Label": "Amazon YVR11, 510 W Georgia St, Vancouver, BC V6B 0M3, Canada", "Country": { "Code2": "CA", "Code3": "CAN", "Name": "Canada" }, "Region": { "Code": "BC", "Name": "British Columbia" }, "SubRegion": { "Name": "Metro Vancouver" }, "Locality": "Vancouver", "District": "Downtown Vancouver", "PostalCode": "V6B 0M3", "Street": "W Georgia St", "StreetComponents": [ { "BaseName": "Georgia", "Type": "St", "TypePlacement": "AfterBaseName", "TypeSeparator": " ", "Prefix": "W", "Language": "en" } ], "AddressNumber": "510" }, "Position": [ -123.11694, 49.28126 ], "Distance": 2336, "Categories": [ { "Id": "business_facility", "Name": "Business Facility", "LocalizedName": "Business Facility", "Primary": true } ], "AccessPoints": [ { "Position": [ -123.11656, 49.28151 ] } ] } ] }
cURL
curl --request POST \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-text?key=Your_Key' \ --header 'Content-Type: application/json' \ --data '{ "QueryText": "Amazon YVR11", "BiasPosition": [ -123.11336, 49.26038 ] }'
AWS CLI
aws geo-places search-text --key ${YourKey} --query-text "Amazon YVR11" --bias-position -123.11336 49.26038