View a markdown version of this page

Come controllare le varianti dei nomi degli indirizzi - Servizio di posizione Amazon

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Come controllare le varianti dei nomi degli indirizzi

AddressNamesModespecifica come vengono restituiti i nomi degli indirizzi. Se non è impostato, il servizio restituisce nomi normalizzati (ufficiali) per impostazione predefinita. Se impostato suMatched, i nomi degli indirizzi nella risposta si basano sulla query di input anziché sui nomi ufficiali. Se impostato suAdministrative, il servizio restituisce i nomi amministrativi ufficiali per i componenti dell'indirizzo. Administrativeattualmente si applica solo agli indirizzi negli Stati Uniti d'America.

Casi d'uso potenziali

  • Completamento del modulo di indirizzo: Matched consente di restituire nomi coerenti con quelli digitati dall'utente, riducendo la confusione nei flussi di lavoro di completamento automatico.

  • Standardizzazione degli indirizzi: Administrative da utilizzare per normalizzare i nomi delle città secondo il formato amministrativo ufficiale per la qualità e la deduplicazione dei dati.

Esempi

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

Suggerimenti per gli sviluppatori

  • Se non è impostato, il servizio restituisce nomi normalizzati (ufficiali) per impostazione predefinita.

  • Administrativeattualmente si applica solo agli indirizzi negli Stati Uniti d'America.