View a markdown version of this page

アドレス名バリアントを制御する方法 - Amazon Location Service

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

アドレス名バリアントを制御する方法

AddressNamesMode は、アドレス名を返す方法を指定します。設定しない場合、サービスはデフォルトで正規化 (公式) 名を返します。に設定するとMatched、レスポンスのアドレス名は公式名ではなく入力クエリに基づきます。に設定するとAdministrative、サービスはアドレスコンポーネントの正式な管理名を返します。 Administrative は現在、米国のアドレスにのみ適用されます。

想定されるユースケース

  • アドレスフォーム補完: を使用して、ユーザーが入力した内容と一致する名前Matchedを返すため、オートコンプリートワークフローの混乱を軽減します。

  • 標準化に対処する: Administrativeを使用して、都市名をデータ品質と重複排除のための公式の管理フォームに正規化します。

Sample request
{ "QueryText": "100 Universal City Plaza, Hollywood, CA", "AddressNamesMode": "Matched" }
Sample response
{ "ResultItems": [ { "PlaceId": "<Redacted>", "PlaceType": "PointAddress", "Title": "100 Universal City Plz, Universal City, CA 91608, United States", "Address": { "Label": "100 Universal City Plz, Universal City, CA 91608, United States", "Country": { "Code2": "US", "Code3": "USA", "Name": "United States" }, "Region": { "Code": "CA", "Name": "California" }, "Locality": "Universal City", "PostalCode": "91608", "Street": "Universal City Plz", "AddressNumber": "100" }, "Position": [ -118.36054, 34.13857 ] } ] }
cURL
curl --request POST \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \ --header 'Content-Type: application/json' \ --data '{ "QueryText": "100 Universal City Plaza, Hollywood, CA", "AddressNamesMode": "Matched" }'
AWS CLI
aws geo-places geocode --key ${YourKey} --query-text "100 Universal City Plaza, Hollywood, CA" --address-names-mode Matched
Sample request
{ "QueryText": "100 Universal City Plaza, Hollywood, CA", "AddressNamesMode": "Administrative" }
Sample response
{ "ResultItems": [ { "PlaceId": "<Redacted>", "PlaceType": "PointAddress", "Title": "100 Universal Terrace Pkwy, Los Angeles, CA 91608, United States", "Address": { "Label": "100 Universal Terrace Pkwy, Los Angeles, CA 91608, United States", "Country": { "Code2": "US", "Code3": "USA", "Name": "United States" }, "Region": { "Code": "CA", "Name": "California" }, "Locality": "Los Angeles", "PostalCode": "91608", "Street": "Universal Terrace Pkwy", "AddressNumber": "100" }, "Position": [ -118.36054, 34.13857 ] } ] }
cURL
curl --request POST \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \ --header 'Content-Type: application/json' \ --data '{ "QueryText": "100 Universal City Plaza, Hollywood, CA", "AddressNamesMode": "Administrative" }'
AWS CLI
aws geo-places geocode --key ${YourKey} --query-text "100 Universal City Plaza, Hollywood, CA" --address-names-mode Administrative

デベロッパー向けのヒント

  • 設定しない場合、サービスはデフォルトで正規化 (公式) 名を返します。

  • Administrative は現在、米国の住所にのみ適用されます。