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à.
Geocodifica con Amazon Location
La geocodifica è un processo che converte il testo, ad esempio un indirizzo, una regione, una ragione sociale o un punto di interesse, in un insieme di coordinate geografiche. È possibile utilizzare le risorse dell'indice di posizione per inviare richieste di geocodifica e incorporare i dati recuperati dalla geocodifica per visualizzare i dati su una mappa per l'applicazione Web o mobile.
Questa sezione illustra come inviare una semplice richiesta di geocodifica e come inviare richieste di geocodifica con specifiche opzionali.
Geocodifica
È possibile inviare una semplice richiesta di geocodifica utilizzando l'SearchPlaceIndexForTextoperazione per convertire un indirizzo in un insieme di coordinate. Una richiesta semplice contiene il seguente parametro obbligatorio:
-
Text— Un indirizzo, nome, città o regione da convertire in un insieme di coordinate. Ad esempio, la stringaAny Town.
Per specificare un numero massimo di risultati per pagina, utilizzate il seguente parametro opzionale:
-
MaxResults— Limita il numero massimo di risultati restituiti nella risposta alla query.
Puoi utilizzare la AWS CLI o la sede AmazonAPIs.
Geocodifica vicino a una posizione
Durante la geocodifica, è possibile geocodificare vicino a una determinata posizione con il seguente parametro opzionale:
-
BiasPosition— La posizione in cui desideri cercare nelle vicinanze. Ciò restringe la ricerca cercando i risultati più vicini alla posizione specificata. Definito come[longitude, latitude]
L'esempio seguente è una SearchPlaceIndexForText richiesta di ricerca nella risorsa dell'indice dei luoghi per un indirizzo, un nome, una città o una regione denominati Any
Town vicino alla posizione [-123.4567,45.6789].
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "BiasPosition": [-123.4567,45.6789] }
Geocodifica all'interno di un riquadro di delimitazione
È possibile geocodificare all'interno di un riquadro di delimitazione per restringere i risultati alle coordinate all'interno di un determinato limite utilizzando il seguente parametro opzionale:
-
FilterBBox— Un riquadro di delimitazione specificato per filtrare i risultati in base alle coordinate all'interno dei confini del riquadro. Definito come[LongitudeSW, LatitudeSW, LongitudeNE, LatitudeNE]Nota
Una richiesta non può contenere sia
FilterBBoxiBiasPositionparametri che. La specificazione di entrambi i parametri nella richiesta restituisce unValidationExceptionerrore.
L'esempio seguente è una SearchPlaceIndexForText richiesta di ricerca all'interno di un riquadro di selezione per un indirizzo, un nome, una città o una regione denominati Any Town. Il bounding box segue che:
-
La longitudine dell'angolo sud-ovest è
-124.1450. -
La latitudine dell'angolo sud-ovest è
41.7045. -
La longitudine dell'angolo nord-est è
-124.1387. -
La latitudine dell'angolo nord-est è
41.7096.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterBBox": [-124.1450,41.7045,-124.1387,41.7096] }
Geocodifica all'interno di un paese
È possibile geocodificare all'interno di uno o più paesi specificati utilizzando il seguente parametro opzionale:
-
FilterCountries— Il paese o la regione in cui desideri eseguire la geocodifica. È possibile definire fino a 100 paesi in una sola richiesta utilizzando un codice del paese ISO3166a tre lettere. Ad esempio, utilizzalo AUSper l'Australia.
L'esempio seguente è una SearchPlaceIndexForText richiesta di ricerca di un indirizzo, un nome, una città o una regione denominati Any Town in Germania e Francia.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterCountries": ["DEU","FRA"] }
Filtraggio per categoria
È possibile filtrare le categorie restituite nella richiesta di geocodifica utilizzando il seguente parametro opzionale:
-
FilterCategories— Le categorie di risultati che desideri vengano restituite nella tua query. È possibile specificare fino a 5 categorie in una richiesta. Puoi trovare l'elenco delle categorie di Amazon Location Service nella sezione Categorie. Ad esempio, puoi specificare diHotelspecificare nella tua query solo gli hotel abituali.
L'esempio seguente è una SearchPlaceIndexForText richiesta di ricerca di una caffetteria denominata Hometown Coffee negli Stati Uniti.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Hometown Coffee", "FilterCategories": ["Coffee Shop"], "FilterCountries": ["USA"] }
Per ulteriori dettagli sul filtraggio in base alle categorie, vedere Posiziona le categorie e filtra i risultati con Amazon Location
Geocodifica in una lingua preferita
È possibile impostare una preferenza di lingua per i risultati della ricerca utilizzando il Language parametro opzionale. Ad esempio, una ricerca di 100 Main
St, Anytown, USA può restituire per 100 Main St, Any Town,
USA impostazione predefinita. Ma se si seleziona fr comeLanguage, è possibile che vengano restituiti 100 Rue
Principale, Any Town, États-Unis invece i risultati.
-
Language— Un codice di lingua da utilizzare per visualizzare i risultati della query. Il valore deve essere un codice di BCP47lingue valido. Ad esempio, enper l'inglese.
Nota
Se non Language è specificato o la lingua specificata non è supportata per un risultato, verrà utilizzata la lingua predefinita del partner per quel risultato.
L'esempio seguente è una SearchPlaceIndexforText richiesta di ricerca di un luogo chiamato Any Town con la lingua preferita specificata comede.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "Language": "de" }
Example response
Di seguito è riportato un esempio di risposta quando chiami l'SearchPlaceIndexForTextoperazione da Amazon Location PlacesAPIs. I risultati includono i luoghi pertinenti e il riepilogo della richiesta. Vengono mostrate due risposte, basate sulla selezione di Esri o HERE come partner.
