Geocoder

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.
Geocoder
Geocoder()
Parametri: nessuno
Crea una nuova istanza di un Geocoder che invia richieste di geocodifica ai server di Google.
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.
address optional
Tipo:  string optional
Indirizzo da geocodificare. Deve essere fornito uno e un solo valore tra address, location e placeId.
bounds optional
LatLngBounds all'interno del quale cercare. (Facoltativo)
componentRestrictions 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)
BetaextraComputations optional
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.
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.
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.
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.
results
L'elenco di GeocoderResult.
Betaaddress_descriptor optional
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.
address_components
Un array di GeocoderAddressComponent
formatted_address
Tipo:  string
Una stringa contenente l'indirizzo leggibile di questa posizione.
geometry
Un oggetto GeocoderGeometry
place_id
Tipo:  string
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.
types
Tipo:  Array<string>
Un array di stringhe che indica il tipo di elemento geocodificato restituito. Per un elenco delle possibili stringhe, consulta la sezione Tipi di componenti di indirizzo della Guida per gli sviluppatori.
Betaaddress_descriptor optional
Tipo:  AddressDescriptor optional
Una descrizione relazionale della posizione associata a questo geocodice. Include un insieme classificato di punti di riferimento nelle vicinanze e le aree contenenti la località target. Questo campo verrà compilato solo per le richieste di geocodifica diretta e di ricerca dell'ID luogo, solo quando ExtraGeocodeComputation.ADDRESS_DESCRIPTORS è abilitato e solo per determinati luoghi localizzati.
partial_match optional
Tipo:  boolean optional
Se il geocoder non ha restituito una corrispondenza esatta per la richiesta originale, anche se è riuscito a trovare una corrispondenza per parte dell'indirizzo richiesto. Se la corrispondenza è esatta, il valore sarà undefined.
plus_code optional
Tipo:  PlacePlusCode optional
Il Plus Code associato alla posizione.
postcode_localities optional
Tipo:  Array<string> optional
Un array di stringhe che indica tutte le località contenute in un codice postale. Questo valore è presente solo quando il risultato è un codice postale che contiene più località.

Interfaccia AddressDescriptor

google.maps.AddressDescriptor interfaccia

Una descrizione relazionale di una località. Include un insieme classificato di punti di riferimento nelle vicinanze e le aree contenenti la località target.
areas
Tipo:  Array<Area>
Un elenco classificato di aree contenenti o adiacenti. Le aree più utili (riconoscibili e precise) sono classificate per prime.
landmarks
Tipo:  Array<Landmark>
Un elenco classificato dei punti di riferimento nelle vicinanze. I punti di riferimento più utili (riconoscibili e vicini) vengono classificati per primi.

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 dell'indirizzo.
long_name
Tipo:  string
Il testo completo del componente dell'indirizzo
short_name
Tipo:  string
Il testo abbreviato del componente dell'indirizzo specificato
types
Tipo:  Array<string>
Un array di stringhe che indica il tipo di questo componente dell'indirizzo. Un elenco dei tipi validi è disponibile qui.

Interfaccia GeocoderGeometry

google.maps.GeocoderGeometry interfaccia

Informazioni sulla geometria di questo GeocoderResult
location
Tipo:  LatLng
Le coordinate di latitudine/longitudine di questo risultato
location_type
Il tipo di località restituito in location
viewport
Tipo:  LatLngBounds
I limiti dell'area visibile consigliata per la visualizzazione di questo GeocoderResult
bounds optional
Tipo:  LatLngBounds optional
I limiti precisi di questo GeocoderResult, se applicabile

Costanti GeocoderLocationType

google.maps.GeocoderLocationType costanti

Descrive il tipo di località restituita da un geocodice. Specificali per valore o utilizzando il nome della costante. Ad esempio, 'ROOFTOP' o google.maps.GeocoderLocationType.ROOFTOP.

Accesso chiamando il numero const {GeocoderLocationType} = await google.maps.importLibrary("geocoding").
Consulta Librerie nell'API Maps JavaScript.
APPROXIMATE Il risultato restituito è approssimativo.
GEOMETRIC_CENTER Il risultato restituito è il centro geometrico di un risultato come una linea (ad es. una strada) o un poligono (una regione).
RANGE_INTERPOLATED Il risultato restituito riflette un'approssimazione (di solito su una strada) interpolata tra due punti precisi (ad esempio incroci). I risultati interpolati vengono generalmente restituiti quando i geocodici del tetto non sono disponibili per un indirizzo stradale.
ROOFTOP Il risultato restituito riflette un geocodice preciso.

Interfaccia Punto di riferimento

google.maps.Landmark interfaccia

Un luogo che rappresenta un punto di riferimento per l'indirizzo.
display_name
Tipo:  string
Il nome del punto di riferimento.
display_name_language_code
Tipo:  string
La lingua del nome del punto di riferimento.
place_id
Tipo:  string
L'ID luogo dell'attività sottostante che funge da punto di riferimento. Può essere utilizzato per risolvere ulteriori informazioni sul punto di riferimento tramite Place Details o Place Id Lookup.
spatial_relationship
Definisce la relazione spaziale tra la posizione di destinazione e il punto di riferimento.
straight_line_distance_meters
Tipo:  number
La distanza in linea retta tra la posizione target e il punto di riferimento.
types
Tipo:  Array<string>
Uno o più valori che indicano il tipo di risultato restituito. Per maggiori dettagli, consulta la sezione Tipi .
travel_distance_meters optional
Tipo:  number optional
La distanza di viaggio lungo la rete stradale tra la località di destinazione e il punto di riferimento. Questo campo può essere vuoto se il punto di riferimento è scollegato dalla parte della rete stradale più vicina alla destinazione OPPURE se la posizione di destinazione non è stata effettivamente considerata parte della rete stradale.

Area interfaccia

google.maps.Area interfaccia

Un luogo che è una piccola regione, ad esempio un quartiere, una località secondaria o un grande complesso che contiene la località di destinazione.
containment
Tipo:  Containment
Definisce la relazione spaziale tra la posizione target e l'area.
display_name
Tipo:  string
Il nome dell'area.
display_name_language_code
Tipo:  string
La lingua del nome dell'area.
place_id
Tipo:  string
L'ID luogo dell'area sottostante. Può essere utilizzato per risolvere ulteriori informazioni sulla zona tramite Place Details o Ricerca ID luogo.

Contenimento costanti

google.maps.Containment costanti

Un'enumerazione che rappresenta la relazione spaziale tra l'area e la posizione target.

Accesso chiamando il numero const {Containment} = await google.maps.importLibrary("geocoding").
Consulta Librerie nell'API Maps JavaScript.
NEAR La posizione di destinazione si trova al di fuori della regione dell'area, ma nelle vicinanze.
OUTSKIRTS La posizione target si trova all'interno della regione dell'area, vicino al bordo.
WITHIN La posizione target si trova all'interno della regione dell'area, vicino al centro.

Costanti SpatialRelationship

google.maps.SpatialRelationship costanti

Un'enumerazione che rappresenta la relazione nello spazio tra il punto di riferimento e la destinazione.

Accesso chiamando il numero const {SpatialRelationship} = await google.maps.importLibrary("geocoding").
Consulta Librerie nell'API Maps JavaScript.
ACROSS_THE_ROAD La destinazione si trova direttamente di fronte al punto di riferimento, sull'altro lato della strada.
AROUND_THE_CORNER Non si trova sullo stesso percorso del punto di riferimento, ma a una sola svolta di distanza.
BEHIND Vicino alla struttura del punto di riferimento, ma più lontano dal punto di accesso.
BESIDE Il target è direttamente adiacente al punto di riferimento.
DOWN_THE_ROAD Sullo stesso percorso del punto di riferimento, ma non accanto o di fronte.
NEAR Questa è la relazione predefinita quando non si applica nulla di più specifico di seguito.
WITHIN Il punto di riferimento ha una geometria spaziale e la destinazione si trova all'interno dei suoi limiti.