Geocoder

Classe Geocoder

google.maps.Geocoder corso

Un servizio per la conversione tra un indirizzo e un LatLng.

Accedi chiamando const {Geocoder} = await google.maps.importLibrary("geocoding"). Consulta la sezione Librerie nell'API Maps JavaScript.
Geocoder
Geocoder()
Parametri: nessuno
Crea una nuova istanza di un Geocoder che invia richieste di geocodifica ai server Google.
geocode
geocode(request[, callback])
Parametri: 
Valore restituito:Promise<GeocoderResponse>
Geocodifica una richiesta.

Interfaccia GeocoderRequest

google.maps.GeocoderRequest interfaccia

La specifica di una richiesta di geocodifica da inviare a Geocoder.
address optional
Tipo:  string optional
Indirizzo da geocodificare. È necessario specificare uno e un solo valore tra address, location e placeId.
bounds optional
LatLngBounds in cui eseguire la ricerca. 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 con uno stato ZERO_RESULT nella risposta. Questo può essere auspicabile perché, anche con zero risultati di geocodifica, potrebbero essere restituiti ulteriori campi a livello di risposta.
language optional
Tipo:  string optional
Un identificatore 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 eseguire la ricerca. Il geocodificatore esegue una geocodifica inversa. Per ulteriori informazioni, consulta la sezione Geocodifica inversa. È necessario specificare uno e un solo valore tra address, location e placeId.
placeId optional
Tipo:  string optional
L'ID luogo associato alla stazione di ricarica. 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 la sezione Geocodifica inversa. È necessario specificare uno e un solo valore tra address, location e placeId.
region optional
Tipo:  string optional
Codice paese utilizzato per orientare la ricerca, specificato come identificatore CLDR / subtag regione Unicode di due caratteri (non numerico). Facoltativo. Consulta la sezione Dettagli sulla copertura di Google Maps Platform per le regioni supportate.

Interfaccia GeocoderComponentRestrictions

google.maps.GeocoderComponentRestrictions interfaccia

GeocoderComponentRestrictions rappresenta un insieme di filtri che rimandano a un'area specifica. Per maggiori dettagli su come funziona, consulta Filtro 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
Corrispondenze 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.

Accedi chiamando const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding"). Consulta la sezione 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 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.
ERROR Si è verificato un problema durante il contatto con i server di Google.
INVALID_REQUEST Questo GeocoderRequest non è 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 Non è stato possibile elaborare una richiesta di geocodifica a causa di un errore del server. La richiesta potrebbe andare a buon fine se riprovi.
ZERO_RESULTS Nessun risultato è stato 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 ExtraGeocodeComputation.ADDRESS_DESCRIPTORS è attivato.
plus_code optional
Tipo:  PlacePlusCode optional
Il Plus Code associato alla località.

Interfaccia GeocoderResult

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, anche se questo risultato è "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 stazione di ricarica.
geometry
Un oggetto GeocoderGeometry
place_id
Tipo:  string
L'ID luogo associato alla stazione di ricarica. 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 di possibili stringhe, consulta la sezione Tipi di componenti dell'indirizzo della Guida per gli sviluppatori.
Betaaddress_descriptor optional
Tipo:  AddressDescriptor optional
Una descrizione relazionale della località associata a questo codice geografico. 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 ricerca di ID luogo e di geocodifica in avanti, solo quando ExtraGeocodeComputation.ADDRESS_DESCRIPTORS è attivato e solo per determinati luoghi localizzati.
partial_match optional
Tipo:  boolean optional
Indica se il geocodificatore non ha restituito una corrispondenza esatta per la richiesta originale, anche se è stato in grado di trovare una corrispondenza per parte dell'indirizzo richiesto. Se si tratta di una corrispondenza esatta, il valore sarà undefined.
plus_code optional
Tipo:  PlacePlusCode optional
Il Plus Code associato alla località.
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 contenente 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) vengono classificate per prime.
landmarks
Tipo:  Array<Landmark>
Un elenco classificato di punti di riferimento nelle vicinanze. I punti di riferimento più utili (riconoscibili e nelle vicinanze) 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.
long_name
Tipo:  string
Il testo completo del componente indirizzo
short_name
Tipo:  string
Il testo breve e 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 applicabili

Costanti GeocoderLocationType

google.maps.GeocoderLocationType costanti

Descrive il tipo di località restituita da un codice geografico. Specificali 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.
APPROXIMATE Il risultato restituito è approssimativo.
GEOMETRIC_CENTER Il risultato restituito è il centro geometrico di un risultato, ad esempio una linea (ad es. una strada) o un poligono (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 codici geografici del tetto non sono disponibili per un indirizzo.
ROOFTOP Il risultato restituito riflette un codice geografico 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 posizione 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 località di destinazione e il punto di riferimento.
straight_line_distance_meters
Tipo:  number
La distanza in linea retta tra la località di destinazione 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 percorsa lungo la rete stradale tra la località di destinazione e il punto di riferimento. Questo campo può essere vuoto se il punto di riferimento non è collegato alla parte della rete stradale più vicina al target OPPURE se la località di destinazione non è stata effettivamente considerata all'interno della rete stradale.

Interfaccia Area

google.maps.Area interfaccia

Un luogo che rappresenta 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 località di destinazione 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 posizione dell'area sottostante. Può essere utilizzato per risolvere ulteriori informazioni sull'area tramite Place Details o Ricerca ID luogo.

Costanti di contenimento

google.maps.Containment costanti

Un enum che rappresenta la relazione spaziale tra l'area e la località di destinazione.

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

Costanti SpatialRelationship

google.maps.SpatialRelationship costanti

Un enum che rappresenta la relazione nello spazio tra il punto di riferimento e il target.

Accedi chiamando const {SpatialRelationship} = await google.maps.importLibrary("geocoding"). Consulta la sezione Librerie nell'API Maps JavaScript.
ACROSS_THE_ROAD Il target si trova direttamente di fronte al punto di riferimento sull'altro lato della strada.
AROUND_THE_CORNER Non 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 si trova direttamente accanto 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 il target si trova all'interno dei suoi limiti.