Classe Geocoder
google.maps.Geocoder
classe
Un servizio per la conversione tra un indirizzo e un LatLng
.
Accesso chiamando il numero const {Geocoder} = await google.maps.importLibrary("geocoding")
.
Consulta 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> Codifica geografica di 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 Indirizzo da geocodificare. Deve essere fornito uno e un solo valore tra address , location e placeId . |
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional LatLngBounds all'interno del quale cercare. (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ù dei seguenti elementi: 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 delle altre richieste di geocodifica. (Facoltativo) |
|
Tipo:
Array<ExtraGeocodeComputation> optional Un elenco di calcoli aggiuntivi che possono essere utilizzati per completare la richiesta. Nota: questi calcoli aggiuntivi potrebbero restituire campi aggiuntivi nella risposta. |
fulfillOnZeroResults optional |
Tipo:
boolean optional Soddisfa la promessa di uno stato ZERO_RESULT nella risposta. Ciò potrebbe essere utile perché anche con zero risultati di geocodifica potrebbero essere restituiti ulteriori campi a livello di risposta. |
language optional |
Tipo:
string optional Un identificatore di lingua per la 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 eseguire la ricerca. Il geocodificatore esegue una geocodifica inversa. Per ulteriori informazioni, consulta Geocodifica inversa. Deve essere fornito uno e un solo valore tra address , location e placeId . |
placeId optional |
Tipo:
string optional L'ID luogo associato alla posizione. 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 saperne di più, consulta Geocodifica inversa. Deve essere fornito uno e un solo valore tra address , location e placeId . |
region optional |
Tipo:
string optional Codice paese utilizzato per orientare la ricerca, specificato come tag secondario di regione Unicode / identificatore CLDR di due caratteri (non numerici). (Facoltativo) Consulta la pagina Dettagli della 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 maggiori dettagli su come funziona, vedi Filtraggio dei componenti di geocodifica.
Proprietà | |
---|---|
administrativeArea optional |
Tipo:
string optional Corrisponde a tutti i administrative_area levels . (Facoltativo) |
country optional |
Tipo:
string optional Corrisponde a un nome di paese o a un codice paese ISO 3166-1 di due lettere. (Facoltativo) |
locality optional |
Tipo:
string optional Corrisponde ai tipi locality e sublocality . (Facoltativo) |
postalCode optional |
Tipo:
string optional Partite postal_code e postal_code_prefix . (Facoltativo) |
route optional |
Tipo:
string optional Corrisponde al nome lungo o breve di un route . (Facoltativo) |
Costanti ExtraGeocodeComputation
google.maps.ExtraGeocodeComputation
costanti
Calcoli aggiuntivi da eseguire durante il completamento di una richiesta di geocodifica.
Accesso chiamando il numero const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding")
.
Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
ADDRESS_DESCRIPTORS |
Genera un descrittore dell'indirizzo. |
Costanti GeocoderStatus
google.maps.GeocoderStatus
costanti
Lo stato restituito da Geocoder
al termine di una chiamata a geocode()
. Specificali per valore o utilizzando il nome della costante. Ad esempio, 'OK'
o google.maps.GeocoderStatus.OK
.
Accesso chiamando il numero const {GeocoderStatus} = await google.maps.importLibrary("geocoding")
.
Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
ERROR |
Si è verificato un problema durante il contatto con i server di Google. |
INVALID_REQUEST |
Questo GeocoderRequest non era valido. |
OK |
La risposta contiene un 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 |
Una richiesta di geocodifica non è stato possibile elaborarla a causa di un errore del server. Se riprovi, la richiesta potrebbe andare a buon fine. |
ZERO_RESULTS |
Nessun risultato trovato per questo GeocoderRequest . |
Interfaccia GeocoderResponse
google.maps.GeocoderResponse
interfaccia
Una risposta del geocodificatore restituita da Geocoder
contenente l'elenco di GeocoderResult
.
Proprietà | |
---|---|
results |
Tipo:
Array<GeocoderResult> L'elenco di GeocoderResult . |
|
Tipo:
AddressDescriptor optional Una descrizione relazionale di una località. Include un insieme classificato di punti di riferimento nelle vicinanze e le aree contenenti la località target. Viene compilato solo per le richieste di geocodifica inversa e solo quando è abilitato ExtraGeocodeComputation.ADDRESS_DESCRIPTORS . |
plus_code optional |
Tipo:
PlacePlusCode optional Il Plus Code associato alla posizione. |
GeocoderResult interfaccia
google.maps.GeocoderResult
interfaccia
Un singolo risultato del geocodificatore recuperato dal server di geocodifica. Una richiesta di geocodifica può restituire più oggetti risultato. Tieni presente che, sebbene questo risultato sia "simile a JSON", non è strettamente JSON, in quanto include indirettamente un oggetto LatLng
.
Proprietà | |
---|---|
address_components |
Tipo:
|