lezione Geocoder
lezione google.maps.Geocoder
Un servizio di conversione tra un indirizzo e un LatLng
.
Accedi chiamando const {Geocoder} = await google.maps.importLibrary("geocoding")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costruttore | |
---|---|
Geocoder |
Geocoder() Parametri: nessuno
Crea una nuova istanza di un Geocoder che invia richieste di geocodifica ai server di Google. |
Metodi | |
---|---|
geocode |
geocode(request[, callback]) Parametri:
Valore restituito:
Promise<GeocoderResponse> Geocodificare una richiesta. |
Interfaccia GeocoderRequest
google.maps.GeocoderRequest
interfaccia
La specifica per una richiesta di geocodifica da inviare a Geocoder
Proprietà | |
---|---|
address optional |
Tipo:
string optional L'indirizzo per la geocodifica. È necessario indicare una sola opzione, ovvero address , location e placeId . |
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional LatLngBounds in cui eseguire la ricerca. Campo facoltativo. |
componentRestrictions optional |
Tipo:
GeocoderComponentRestrictions optional I componenti vengono utilizzati per limitare i risultati a un'area specifica. Un filtro è costituito da uno o più tra: route , locality , administrativeArea , postalCode , country . Verranno restituiti solo i risultati che corrispondono a tutti i filtri. I valori dei filtri supportano gli stessi metodi di correzione ortografica e corrispondenza parziale di altre richieste di geocodifica. Campo facoltativo. |
language optional |
Tipo:
string optional L'identificatore della lingua della lingua in cui devono essere restituiti i risultati, se possibile. Consulta l'elenco delle lingue supportate. |
location optional |
Tipo:
LatLng|LatLngLiteral optional LatLng (o LatLngLiteral ) per cui cercare. Il geocodificatore esegue una geocodifica inversa. Per ulteriori informazioni, consulta la pagina Reverse Geocoding. È necessario indicare una sola opzione, ovvero address , location e placeId . |
placeId optional |
Tipo:
string optional L'ID del luogo associato alla sede. Gli ID luogo identificano in modo univoco un luogo nel database di Google Places e su Google Maps. Scopri di più sugli ID luogo nella guida per gli sviluppatori dell'API Places. Il geocodificatore esegue una geocodifica inversa. Per ulteriori informazioni, consulta la sezione Codifica geografica inversa. È necessario indicare una sola opzione, ovvero address , location e placeId . |
region optional |
Tipo:
string optional Codice paese utilizzato per polizzare la ricerca, specificato come sottotag di regione Unicode / identificatore CLDR di due caratteri (non numerico). Campo facoltativo. Consulta i dettagli di copertura di Google Maps Platform per le regioni supportate. |
Interfaccia GeocoderComponentRestrictions
google.maps.GeocoderComponentRestrictions
interfaccia
GeocoderComponentRestrictions
rappresenta un insieme di filtri che si risolvono in un'area specifica. Per informazioni dettagliate su questa procedura, consulta la sezione Filtro dei componenti di geocodifica.
Proprietà | |
---|---|
administrativeArea optional |
Tipo:
string optional Corrisponde a tutti i administrative_area levels Campo facoltativo. |
country optional |
Tipo:
string optional Corrisponde al nome di un paese o a un codice paese ISO 3166-1 di due lettere. Campo facoltativo. |
locality optional |
Tipo:
string optional Corrisponde ai tipi locality e sublocality . Campo facoltativo. |
postalCode optional |
Tipo:
string optional Corrisponde a postal_code e postal_code_prefix . Campo facoltativo. |
route optional |
Tipo:
string optional Corrisponde al nome lungo o breve di route . Campo facoltativo. |
Costanti di GeocoderStatus
google.maps.GeocoderStatus
costanti
Lo stato restituito da Geocoder
al termine di una chiamata al numero geocode()
. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'OK'
o google.maps.GeocoderStatus.OK
.
Accedi chiamando const {GeocoderStatus} = await google.maps.importLibrary("geocoding")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
ERROR |
Si è verificato un problema durante la connessione ai server di Google. |
INVALID_REQUEST |
Questa GeocoderRequest non era valida. |
OK |
La risposta contiene un elemento GeocoderResponse valido. |
OVER_QUERY_LIMIT |
La pagina web ha superato il limite di richieste in un periodo di tempo troppo breve. |
REQUEST_DENIED |
La pagina web non è autorizzata a utilizzare il geocodificatore. |
UNKNOWN_ERROR |
Impossibile elaborare una richiesta di geocodifica a causa di un errore del server. Se riprovi, la richiesta potrebbe avere esito positivo. |
ZERO_RESULTS |
Nessun risultato per GeocoderRequest . |
Interfaccia GeocoderResponse
google.maps.GeocoderResponse
interfaccia
Una risposta Geocoder restituita da Geocoder
contenente l'elenco di GeocoderResult
.
Proprietà | |
---|---|
results |
Tipo:
Array<GeocoderResult> L'elenco di GeocoderResult . |
Interfaccia GeocoderResult
google.maps.GeocoderResult
interfaccia
Un singolo risultato del geocodifica recuperato dal server di geocodifica. Una richiesta di geocodifica può restituire più oggetti risultato. Anche se il risultato è "simile a JSON", non è strettamente JSON perché include indirettamente un oggetto LatLng
.
Proprietà | |
---|---|
address_components |
Tipo:
Array<GeocoderAddressComponent> Un array di GeocoderAddressComponent s |
formatted_address |
Tipo:
string Una stringa contenente l'indirizzo leggibile di questo luogo. |
geometry |
Tipo:
GeocoderGeometry Un oggetto GeocoderGeometry |
place_id |
Tipo:
string L'ID del luogo associato alla sede. Gli ID luogo identificano in modo univoco un luogo nel database di Google Places e su Google Maps. Scopri di più sugli ID luogo nella guida per gli sviluppatori dell'API Places. |
types |
Tipo:
Array<string> Un array di stringhe che indicano il tipo di elemento geocodificato restituito. Per un elenco delle possibili stringhe, consulta la sezione Tipi di componenti degli indirizzi della Guida per gli sviluppatori. |
partial_match optional |
Tipo:
boolean optional Indica se il geocodificatore non ha restituito una corrispondenza esatta per la richiesta originale, anche se è riuscita a far corrispondere parte dell'indirizzo richiesto. Se si tratta di una corrispondenza esatta, il valore è undefined . |
plus_code optional |
Tipo:
PlacePlusCode optional Il Plus Code associato alla sede. |
postcode_localities optional |
Tipo:
Array<string> optional Un array di stringhe che indicano tutte le località contenute in un codice postale. È presente solo quando il risultato è un codice postale che contiene più località. |
Interfaccia GeocoderAddressComponent
google.maps.GeocoderAddressComponent
interfaccia
Un singolo componente dell'indirizzo all'interno di un GeocoderResult
. Un indirizzo completo può essere composto da più componenti.
Proprietà | |
---|---|
long_name |
Tipo:
string Il testo completo del componente dell'indirizzo |
short_name |
Tipo:
string Il testo breve e abbreviato del componente dell'indirizzo specificato |
types |
Tipo:
Array<string> Un array di stringhe che indicano il tipo di questo indirizzo. Puoi trovare un elenco dei tipi validi qui |
Interfaccia GeocoderGeometry
google.maps.GeocoderGeometry
interfaccia
Informazioni di geometria relative a questo GeocoderResult
Proprietà | |
---|---|
location |
Tipo:
LatLng Le coordinate di latitudine/longitudine di questo risultato |
location_type |
Tipo:
GeocoderLocationType Il tipo di località restituito in location |
viewport |
Tipo:
LatLngBounds I limiti dell'area visibile consigliata per la visualizzazione di questo elemento GeocoderResult |
bounds optional |
Tipo:
LatLngBounds optional I limiti precisi di questo elemento GeocoderResult , se applicabile |
Costanti GeocoderLocationType
google.maps.GeocoderLocationType
costanti
Descrive il tipo di località restituita da un codice geografico. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'ROOFTOP'
o google.maps.GeocoderLocationType.ROOFTOP
.
Accedi chiamando const {GeocoderLocationType} = await google.maps.importLibrary("geocoding")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
APPROXIMATE |
Il risultato restituito è approssimativo. |
GEOMETRIC_CENTER |
Il risultato restituito è il centro geometrico di un risultato, ad esempio una linea (ad es. strada) o un poligono (area geografica). |
RANGE_INTERPOLATED |
Il risultato restituito riflette un'approssimazione (generalmente su una strada) interpolata tra due punti precisi (come degli incroci). I risultati interpolati vengono generalmente restituiti se non sono disponibili i codici geografici panoramici per un indirizzo. |
ROOFTOP |
Il risultato restituito riflette un codice geografico preciso. |