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 usare ReverseGeocode
Questa sezione contiene una serie di guide pratiche ed esempi per l'uso ReverseGeocode APIs.
**Topics**
+ [Come invertire la geocodifica di una posizione](how-to-reverse-geocode-position.md)
+ [Come invertire la geocodifica per ottenere risultati corretti](reverse-geocode-filter-right-result.md)
+ [Come eseguire la geocodifica inversa in una lingua specifica](how-to-reverse-geocode-specific-language.md)
+ [Come invertire la geocodifica per il fuso orario di una città](how-to-reverse-geocode-timezone.md)
+ [Come eseguire la geocodifica inversa con una visione politica](reverse-geocode-political-view.md)
+ [Come ottenere intersezioni](reverse-how-to-get-intersections.md)
# Come invertire la geocodifica di una posizione
L'API Reverse Geocode consente di convertire un geocodice in un'area geografica in base a una query di posizione. La risposta dell'API include i dettagli del luogo, fornendo informazioni sulla posizione associata a coordinate specifiche.
## Casi d'uso potenziali
+ **Memorizza informazioni sul luogo:** aggiungi i dettagli del luogo a un datastore contenente coordinate geografiche.
+ **Visualizzazione della mappa:** utilizza le informazioni sul luogo per visualizzare i dati su una mappa.
+ **Rilevamento della posizione dell'utente:** identifica la posizione dell'utente in base alla posizione del dispositivo.
## Geocodifica inversa una posizione
------
#### [ Sample request ]
```
{
"QueryPosition": [
-123.11694,
49.28126
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointAddress",
"Title": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
"Address": {
"Label": "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": 0,
"MapView": [-123.11813, 49.27786, -123.11076, 49.28246],
"AccessPoints": [
{ "Position": [-123.11656, 49.28151] }
]
}
]
}
```
------
#### [ 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": [
-123.11694,
49.28126
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places reverse-geocode --key ${YourKey} --query-position "-123.11694,49.28126"
```
------
## Geocodifica inversa una posizione con più risultati
------
#### [ Sample request ]
```
{
"QueryPosition": [
-123.11694,
49.28126
],
"MaxResults": "3"
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointAddress",
"Title": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
"Address": { /* Address details */ },
"Position": [-123.11694, 49.28126],
"Distance": 0,
"MapView": [/* Map view details */],
"AccessPoints": [/* Access point details */]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "ChargePoint",
"Address": { /* Address details */ },
"Position": [-123.11663, 49.28116],
"Distance": 25,
"Categories": [/* Category details */],
"AccessPoints": [/* Access point details */]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Zipcar",
"Address": { /* Address details */ },
"Position": [-123.11715, 49.28094],
"Distance": 29,
"Categories": [/* Category details */],
"AccessPoints": [/* Access point details */]
}
]
}
```
------
#### [ 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": [
-123.11694,
49.28126
],
"MaxResults": "3"
}'
```
------
#### [ AWS CLI ]
```
aws geo-places reverse-geocode --key ${YourKey} --query-position "-123.11694,49.28126" --max-results "3"
```
------
## Suggerimenti per gli sviluppatori
Per risultati mirati, utilizzali `IncludePlaceTypes` nel filtro.
```
{
"QueryPosition": [
-123.11694,
49.28126
],
"Filter": { "IncludePlaceTypes": ["PointAddress"] }
}
```
# Come invertire la geocodifica per ottenere risultati corretti
Questa guida fornisce metodi per perfezionare i risultati della geocodifica inversa, garantendo che i dati restituiti siano strettamente allineati alle esigenze aziendali specifiche. Utilizzando i filtri, gli utenti possono restringere i risultati in modo da corrispondere con maggiore precisione a tipi come punti di indirizzo, strade o località.
## Casi d'uso potenziali
+ **Limita i risultati per esigenze specifiche:** utilizza i filtri per recuperare solo le informazioni più pertinenti, ad esempio indirizzi esatti o dati più ampi sulla località, in base ai requisiti aziendali.
## Esempi
### Filtra per un indirizzo di punto
Filtrando per`PointAddress`, puoi recuperare indirizzi stradali specifici, migliorando la precisione della posizione.
------
#### [ Sample Request ]
```
{
"QueryPosition": [
-97.721, 30.404
],
"Filter": {
"IncludePlaceTypes": [
"PointAddress"
]
}
}
```
------
#### [ Sample Response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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"]}'
```
------
### Filtra per una strada
Filtrando per`Street`, l'API restituisce dati a livello stradale senza numeri di indirizzo specifici.
------
#### [ Sample Request ]
```
{
"QueryPosition": [
-97.721, 30.404
],
"Filter": {
"IncludePlaceTypes": [
"Street"
]
}
}
```
------
#### [ Sample Response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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"]}'
```
------
### Filtra per una località
Filtrando per`Locality`, puoi recuperare dati sulla posizione più ampi, inclusi i nomi delle città.
------
#### [ Sample Request ]
```
{
"QueryPosition": [
-97.721, 30.404
],
"Filter": {
"IncludePlaceTypes": [
"Locality"
]
}
}
```
------
#### [ Sample Response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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"]}'
```
------
# Come eseguire la geocodifica inversa in una lingua specifica
La funzionalità consente la selezione di un linguaggio di risposta preferito tra codici BCP47 conformi. Rileva il linguaggio di interrogazione in base alle varianti dei nomi e utilizza il linguaggio preferito per token senza pari e casi ambigui. Se non è richiesta alcuna lingua, l'API **Places** fornisce i risultati nella lingua ufficiale del paese, ma dà priorità alla lingua regionale nelle regioni in cui è diversa. Come strategia di riserva, se alcuni elementi dell'indirizzo non sono disponibili nella lingua richiesta, **Places APIs restituisce** gli indirizzi nella lingua predefinita.
## Casi d'uso potenziali
Un possibile caso d'uso è quello di localizzare and/or la query come risultato.
## Esempi
### Ottieni il risultato in una lingua specifica
------
#### [ Sample request ]
```
{
"QueryPosition": [
139.69172,
35.6895
],
"Language": "JA"
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointAddress",
"Title": "2-8-1 Nishishinjuku, Shinjuku-ku, Tokyo 160-0023, Japan",
"Address": {
"Label": "2-8-1 Nishishinjuku, Shinjuku-ku, Tokyo 160-0023, Japan",
"Country": {
"Code2": "JP",
"Code3": "JPN",
"Name": "Japan"
},
"Region": {
"Name": "Tokyo"
},
"SubRegion": {},
"Locality": "Shinjuku-ku",
"SubDistrict": "Nishishinjuku",
"PostalCode": "160-0023",
"Block": "2 Chome",
"SubBlock": "8",
"AddressNumber": "1"
},
"Position": [
139.69171,
35.68949
],
"Distance": 1,
"MapView": [
139.69071,
35.68861,
139.69251,
35.69048
],
"AccessPoints": [
{
"Position": [
139.69206,
35.68954
]
}
]
}
]
}
```
------
#### [ 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": [
139.69172,
35.6895
],
"Language": "JA"
}'
```
------
#### [ AWS CLI ]
```
aws geo-places reverse-geocode --key ${YourKey} --query-position 139.69172 35.6895 --language "JA"
```
------
# Come invertire la geocodifica per il fuso orario di una città
È possibile utilizzare l'API Reverse Geocode per richiedere informazioni sul fuso orario, come l'offset UTC e il nome del fuso orario
## Potenziale utilizzo
Possibili utilizzi per la geocodifica dei fusi orari:
+ Crea un orologio mondiale
+ Pianifica riunioni in diverse aree geografiche
## Esempi
### Esempio
Geocodifica inversa una località a Tokyo, con richiesta del fuso orario.
------
#### [ Sample request ]
```
{
"QueryPosition": [
139.69172,
35.6895
],
"AdditionalFeatures": [
"TimeZone"
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointAddress",
"Title": "〒160-0023 東京都新宿区西新宿2丁目8-1",
"Address": {
"Label": "〒160-0023 東京都新宿区西新宿2丁目8-1",
"Country": {
"Code2": "JP",
"Code3": "JPN",
"Name": "日本"
},
"Region": {
"Name": "東京都"
},
"SubRegion": {},
"Locality": "新宿区",
"SubDistrict": "西新宿",
"PostalCode": "160-0023",
"Block": "2丁目",
"SubBlock": "8",
"AddressNumber": "1"
},
"Position": [
139.69171,
35.68949
],
"Distance": 1,
"MapView": [
139.69071,
35.68861,
139.69251,
35.69048
],
"AccessPoints": [
{
"Position": [
139.69206,
35.68954
]
}
],
"TimeZone": {
"Name": "Asia/Tokyo",
"Offset": "+09:00",
"OffsetSeconds": 32400
}
}
]
}
```
------
#### [ 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": [
139.69172,
35.6895
],
"AdditionalFeatures": [
"TimeZone"
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places reverse-geocode --key ${YourKey} --query-position 139.69172 35.6895 --additional-features "TimeZone"
```
------
# Come eseguire la geocodifica inversa con una visione politica
Amazon Location Service ti consente di specificare una visione politica per garantire che la tua applicazione sia conforme alle normative locali. Questa funzionalità è utile per la geocodifica di località in aree contese in cui i nomi dei luoghi o i confini possono variare a seconda delle opinioni politiche.
## Casi d'uso potenziali
**Rispetta le politiche locali:** assicurati che i nomi dei luoghi e i confini siano conformi ai requisiti legali della visione politica selezionata.
## Esempi
### Geocodifica inversa una posizione contestata
------
#### [ Sample Request ]
```
{
"QueryPosition": [
33.95876,
45.46824
],
"PoliticalView": "RUS"
}
```
------
#### [ Sample Response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "Locality",
"Title": "Первомайский район, Южный федеральный округ, Россия",
"Address": {
"Label": "Первомайский район, Южный федеральный округ, Россия",
"Country": {
"Code2": "RU",
"Code3": "RUS",
"Name": "Россия"
},
"Region": {
"Name": "Южный федеральный округ"
},
"SubRegion": {
"Name": "Республика Крым"
},
"Locality": "Первомайский район"
},
"Position": [
33.85939,
45.7142
],
"Distance": 0,
"MapView": [
33.52692,
45.34303,
34.12277,
45.80953
],
"PoliticalView": "RUS"
}
]
}
```
------
#### [ 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": [
33.95876,
45.46824
],
"PoliticalView": "RUS"
}'
```
------
#### [ AWS CLI ]
```
aws geo-places reverse-geocode --key ${YourKey} --query-position 33.95876 45.46824 --political-view "RUS"
```
------
# Come ottenere intersezioni
ReverseGeocode L'API può recuperare le intersezioni vicine alla posizione specificata.
## Potenziale caso d'uso
**Recupera tutte le intersezioni vicine.**Questo può essere utilizzato dai servizi di emergenza e dai corrieri di consegna. I veicoli di pronto intervento spesso devono identificare gli incroci vicini per un posizionamento ottimale quando rispondono alle chiamate. Ciò consente loro di mantenere percorsi di accesso chiari e tempi di risposta più rapidi, garantendo al contempo la visibilità da più approcci. Allo stesso modo, i corrieri possono utilizzare i dati degli incroci per trovare parcheggi più efficienti, specialmente nelle aree urbane densamente popolate dove il door-to-door parcheggio può essere limitato o limitato.
## Raggiungi gli incroci vicini
Le intersezioni vengono restituite quando il tipo di risultato è Street PointAddress, o. InterpolatedAddress Per assicurarti di raggiungere intersezioni vicine, imposta il `Heading` parametro o il filtro per Street PointAddress, or InterpolatedAddress types.
## Raggiungi gli incroci vicini con Heading
------
#### [ Sample request ]
```
{
"QueryPosition": [-123.11694, 49.28126],
"AdditionalFeatures": ["Intersections"],
"Heading": 45
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointAddress",
"Title": "510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
"Address": {
"Label": "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": 0,
"MapView": [
-123.11813,
49.27786,
-123.11076,
49.28246
],
"Intersections": [
{
"PlaceId": "",
"Title": "W Georgia St & Richards St, Vancouver, BC V6B, Canada",
"Address": {
"Label": "W Georgia St & Richards St, Vancouver, BC V6B, Canada",
"PostalCode": "V6B",
"Intersection": [
"W Georgia St",
"Richards St"
]
},
"Position": [
-123.11614,
49.28124
],
"Distance": 58
},
{
"PlaceId": "",
"Title": "W Georgia St & Seymour St, Vancouver, BC V6B, Canada",
"Address": {
"Label": "W Georgia St & Seymour St, Vancouver, BC V6B, Canada",
"PostalCode": "V6B",
"Intersection": [
"W Georgia St",
"W Georgia St",
"Seymour St",
"Seymour St"
]
},
"Position": [
-123.11712,
49.28186
],
"Distance": 68
}
]
}
]
}
```
------
#### [ 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": [
-123.11694, 49.28126
],
"AdditionalFeatures": ["Intersections"],
"Heading": 45
}
```
------
#### [ AWS CLI ]
```
aws geo-places reverse-geocode --key ${YourKey} --query-position -123.11694, 49.28126 --additional-features "Intersections" --heading 45
```
------
## Raggiungi gli incroci nelle vicinanze con Street Filter
------
#### [ Sample request ]
```
{
"QueryPosition": [-123.11694, 49.28126],
"AdditionalFeatures": ["Intersections"],
"Filter": {
"IncludePlaceTypes": ["Street"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "Street",
"Title": "W Georgia St, Vancouver, BC V6B, Canada",
"Address": {
"Label": "W Georgia St, Vancouver, BC V6B, 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",
"Street": "W Georgia St",
"StreetComponents": [
{
"BaseName": "Georgia",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "W",
"Language": "en"
}
]
},
"Position": [
-123.11694,
49.28126
],
"Distance": 0,
"MapView": [
-123.11813,
49.27786,
-123.11076,
49.28246
],
"Intersections": [
{
"PlaceId": "",
"Title": "W Georgia St & Richards St, Vancouver, BC V6B, Canada",
"Address": {
"Label": "W Georgia St & Richards St, Vancouver, BC V6B, Canada",
"PostalCode": "V6B",
"Intersection": [
"W Georgia St",
"Richards St"
]
},
"Position": [
-123.11614,
49.28124
],
"Distance": 58
},
{
"PlaceId": "",
"Title": "W Georgia St & Seymour St, Vancouver, BC V6B, Canada",
"Address": {
"Label": "W Georgia St & Seymour St, Vancouver, BC V6B, Canada",
"PostalCode": "V6B",
"Intersection": [
"W Georgia St",
"W Georgia St",
"Seymour St",
"Seymour St"
]
},
"Position": [
-123.11712,
49.28186
],
"Distance": 68
}
]
}
]
}
```
------
#### [ 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": [
-123.11694, 49.28126
],
"AdditionalFeatures": ["Intersections"],
"Filter": {
"IncludePlaceTypes": ["Street"]
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-places reverse-geocode --key ${YourKey} --query-position -123.11694, 49.28126 --additional-features "Intersections" --filter '{"IncludePlaceTypes": ["Street"]}'
```
------