本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
如何反向地理编码以获得正确的结果
本指南提供了优化反向地理编码结果的方法,可确保返回的数据与特定的业务需求紧密一致。使用过滤器,用户可以缩小结果范围,以便更精确地匹配地址点、街道或地点等类型。
潜在用例
-
根据@@ 特定需求限制搜索结果:根据业务需求,使用筛选器仅检索最相关的信息,例如确切地址或更广泛的地理位置数据。
示例
通过筛选PointAddress
,您可以检索特定的街道地址,从而提高位置的准确性。
- Sample Request
-
{ "QueryPosition": [ -97.721, 30.404 ], "Filter": { "IncludePlaceTypes": [ "PointAddress" ] } }
- Sample Response
-
{ "ResultItems": [ { "PlaceId": "<Redacted>", "PlaceType": "PointAddress", "Title": "11721 Domain Blvd, Austin, TX 78758-0051, United States", "Address": { "Label": "11721 Domain Blvd, Austin, TX 78758-0051, United States", "Country": { "Code2": "US", "Code3": "USA", "Name": "United States" }, "Region": { "Code": "TX", "Name": "Texas" }, "SubRegion": { "Name": "Travis" }, "Locality": "Austin", "District": "North Burnet", "PostalCode": "78758-0051", "Street": "Domain Blvd", "StreetComponents": [ { "BaseName": "Domain", "Type": "Blvd", "TypePlacement": "AfterBaseName", "TypeSeparator": " ", "Language": "en" } ], "AddressNumber": "11721" }, "Position": [ -97.72087, 30.404 ], "Distance": 5, "MapView": [ -97.72219, 30.40273, -97.72057, 30.40649 ] } ] }
- cURL
-
curl --request POST \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/reverse-geocode?key=Your_Key' \ --header 'Content-Type: application/json' \ --data '{ "{ "QueryPosition": [ -97.721, 30.404 ], "Filter": { "IncludePlaceTypes": [ "PointAddress" ] }'
- AWS CLI
-
aws geo-places reverse-geocode --key ${YourKey} --query-position -97.721 30.404 --filter '{"IncludePlaceTypes": ["PointAddress"]}'
通过筛选Street
,API 会返回没有特定地址号的街道级数据。
- Sample Request
-
{ "QueryPosition": [ -97.721, 30.404 ], "Filter": { "IncludePlaceTypes": [ "Street" ] } }
- Sample Response
-
{ "ResultItems": [ { "PlaceId": "<Redacted>", "PlaceType": "Street", "Title": "Domain Blvd, Austin, TX 78758, United States", "Address": { "Label": "Domain Blvd, Austin, TX 78758, United States", "Country": { "Code2": "US", "Code3": "USA", "Name": "United States" }, "Region": { "Code": "TX", "Name": "Texas" }, "SubRegion": { "Name": "Travis" }, "Locality": "Austin", "District": "North Burnet", "PostalCode": "78758", "Street": "Domain Blvd", "StreetComponents": [ { "BaseName": "Domain", "Type": "Blvd", "TypePlacement": "AfterBaseName", "TypeSeparator": " ", "Language": "en" } ] }, "Position": [ -97.72103, 30.40399 ], "Distance": 3, "MapView": [ -97.72219, 30.40273, -97.72057, 30.40649 ] } ] }
- cURL
-
curl --request POST \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/reverse-geocode?key=Your_Key' \ --header 'Content-Type: application/json' \ --data '{ "{ "QueryPosition": [ -97.721, 30.404 ], "Filter": { "IncludePlaceTypes": [ "Street" ] }'
- AWS CLI
-
aws geo-places reverse-geocode --key ${YourKey} --query-position -97.721 30.404 --filter '{"IncludePlaceTypes": ["Street"]}'
通过筛选Locality
,您可以检索更广泛的位置数据,包括城市名称。
- Sample Request
-
{ "QueryPosition": [ -97.721, 30.404 ], "Filter": { "IncludePlaceTypes": [ "Locality" ] } }
- Sample Response
-
{ "ResultItems": [ { "PlaceId": "<Redacted>", "PlaceType": "Locality", "Title": "Austin, TX, United States", "Address": { "Label": "Austin, TX, United States", "Country": { "Code2": "US", "Code3": "USA", "Name": "United States" }, "Region": { "Code": "TX", "Name": "Texas" }, "SubRegion": { "Name": "Travis" }, "Locality": "Austin", "PostalCode": "78701" }, "Position": [ -97.74299, 30.26759 ], "Distance": 0, "MapView": [ -98.06484, 30.06592, -97.55914, 30.51965 ] } ] }
- cURL
-
curl --request POST \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/reverse-geocode?key=Your_Key' \ --header 'Content-Type: application/json' \ --data '{ "{ "QueryPosition": [ -97.721, 30.404 ], "Filter": { "IncludePlaceTypes": [ "Locality" ] }'
- AWS CLI
-
aws geo-places reverse-geocode --key ${YourKey} --query-position -97.721 30.404 --filter '{"IncludePlaceTypes": ["Locality"]}'
对某个位置进行反向地理编码
用一种语言进行反向地理编码