Geocoder

Geocoder

google.maps.Geocoder classe

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 elemento Geocoder che invia richieste di codici geografici ai server di Google.
geocode
geocode(request[, callback])
Parametri: 
Valore restituito:  Promise<GeocoderResponse>
Geocodifica una richiesta.

Interfaccia GeocoderRequest

Interfaccia google.maps.GeocoderRequest

La specifica per una richiesta di geocodifica da inviare a Geocoder.
address optional
Tipo:  string optional
Indirizzo da geocodificare. Devi specificare un solo elemento di address, location e placeId.
bounds optional
LatLngBounds all'interno del quale eseguire la ricerca. Campo facoltativo.
componentRestrictions optional
I componenti vengono utilizzati per limitare i risultati a un'area specifica. Un filtro è costituito da uno o più di: route, locality, administrativeArea, postalCode, country. Verranno restituiti solo i risultati che corrispondono a tutti i filtri. I valori del filtro supportano gli stessi metodi di correzione ortografica e corrispondenza parziale delle altre richieste di geocodifica. Campo 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
Mantieni la promessa con uno stato ZERO_RESULT nella risposta. Questo può essere utile perché anche senza risultati di geocodifica potrebbero essere restituiti campi aggiuntivi del livello di risposta.
language optional
Tipo:  string optional
Un identificatore della lingua per la lingua in cui restituire i risultati, se possibile. Consulta l'elenco delle lingue supportate.
location optional
Tipo:  LatLng|LatLngLiteral optional
LatLng (o LatLngLiteral) di cui cercare. Il geocodificatore esegue un geocodice inverso. Per ulteriori informazioni, consulta la sezione Reverse Geocoding. Devi specificare un solo elemento di 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 un geocodice inverso. Per ulteriori informazioni, consulta la sezione Reverse Geocoding. Devi specificare un solo elemento di address, location e placeId.
region optional
Tipo:  string optional
Codice paese utilizzato per differenziare la ricerca, specificato come sottotag di regione Unicode / identificatore CLDR a due caratteri (non numerico). Campo facoltativo. Consulta i dettagli sulla copertura di Google Maps Platform per le regioni supportate.

Interfaccia GeocoderComponentRestrictions

Interfaccia google.maps.GeocoderComponentRestrictions

GeocoderComponentRestrictions rappresenta un insieme di filtri che si risolvono in un'area specifica. Per informazioni dettagliate, consulta la pagina Filtro dei componenti di geocodifica.
administrativeArea optional
Tipo:  string optional
Corrisponde a tutti i criteri 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 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 di indirizzo.

Costanti GeocoderStatus

google.maps.GeocoderStatus costanti

Lo stato restituito da Geocoder al completamento 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 tentativo di contattare i server di Google.
INVALID_REQUEST Questo GeocoderRequest non è valido.
OK La risposta contiene un valore 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 riuscire.
ZERO_RESULTS Nessun risultato trovato per GeocoderRequest.

Interfaccia GeocoderResponse

Interfaccia google.maps.GeocoderResponse

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 un luogo. 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 è abilitato.
plus_code optional
Tipo:  PlacePlusCode optional
Il plus code associato alla sede.

Interfaccia GeocoderResult

Interfaccia google.maps.GeocoderResult

Un singolo risultato di un geocodice recuperato dal server geocodificato. Una richiesta di geocodice potrebbe restituire più oggetti con risultati. Tieni presente che anche se questo risultato è di tipo "simile a JSON", non è strettamente JSON, poiché include indirettamente un oggetto LatLng.
address_components
Un array di GeocoderAddressComponent
formatted_address
Tipo:  string
Una stringa contenente l'indirizzo leggibile di questa località.
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 dell'elemento geocodificato restituito. Per un elenco di possibili stringhe, consulta la sezione Tipi di componenti per l'indirizzo della Guida per gli sviluppatori.
Betaaddress_descriptor optional
Tipo:  AddressDescriptor optional
Una descrizione relazionale della località 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 la geocodifica in avanti e le richieste di ricerca dell'ID luogo, solo quando il campo ExtraGeocodeComputation.ADDRESS_DESCRIPTORS è attivato e solo per alcuni luoghi localizzati.
partial_match optional
Tipo:  boolean optional
Indica se il geocodificatore non ha restituito una corrispondenza esatta per la richiesta originale, nonostante sia riuscita a far corrispondere parte dell'indirizzo richiesto. Se viene utilizzata una corrispondenza esatta, il valore sarà 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 AddressDescriptor

Interfaccia google.maps.AddressDescriptor

Una descrizione relazionale di un luogo. 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 posizionate per prime.
landmarks
Tipo:  Array<Landmark>
Un elenco classificato dei punti di riferimento nelle vicinanze. I punti di riferimento più utili (riconoscibili e nelle vicinanze) vengono classificati per primi.

Interfaccia GeocoderAddressComponent

Interfaccia google.maps.GeocoderAddressComponent

Un singolo componente indirizzo in un elemento GeocoderResult. Un indirizzo completo può essere composto da più componenti.
long_name
Tipo:  string
Il testo completo del componente dell'indirizzo
short_name
Tipo:  string
Il breve testo abbreviato del componente indirizzo specificato
types
Tipo:  Array<string>
Un array di stringhe che indicano il tipo di questo componente dell'indirizzo. Un elenco dei tipi validi è disponibile qui.

Interfaccia GeocoderGeometry

Interfaccia google.maps.GeocoderGeometry

Informazioni geometriche su 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 GeocoderResult
bounds optional
Tipo:  LatLngBounds optional
I limiti precisi di questo GeocoderResult, se applicabili

Costanti di GeocoderLocationType

google.maps.GeocoderLocationType costanti

Descrive il tipo di posizione restituito da un geocodice. 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 di una linea (ad es. strada) o di un poligono (regione).
RANGE_INTERPOLATED Il risultato restituito riflette un'approssimazione (di solito su una strada) interpolata tra due punti precisi (ad esempio gli incroci). I risultati interpolati vengono generalmente restituiti quando i codici geografici sui tetti non sono disponibili per un indirizzo.
ROOFTOP Il risultato restituito riflette un geocodice preciso.

Interfaccia Un punto di riferimento

Interfaccia google.maps.Landmark

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 trovare 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 del risultato restituito. Per ulteriori dettagli, consulta Tipi .
travel_distance_meters optional
Tipo:  number optional
La distanza da percorrere lungo la rete stradale tra la località target e il punto di riferimento. Questo campo può essere deselezionato se il punto di riferimento è disconnesso dalla parte della rete stradale a cui il target è più vicino OPPURE se la località target non è stata effettivamente considerata sulla rete stradale.

Interfaccia ad area

Interfaccia google.maps.Area

Un luogo costituito da una piccola regione, come un quartiere, una zona secondaria o un grande complesso che contiene la località target.
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 trovare ulteriori informazioni sull'area tramite Place Details o la ricerca ID luogo.

Costanti di contenimento

google.maps.Containment costanti

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

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

Costanti di SpatialRelationship

google.maps.SpatialRelationship costanti

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

Accedi chiamando const {SpatialRelationship} = await google.maps.importLibrary("geocoding"). Consulta la sezione Librerie nell'API Maps JavaScript.
ACROSS_THE_ROAD L'obiettivo si trova proprio 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 suo punto di accesso.
BESIDE Il target è direttamente adiacente al punto di riferimento.
DOWN_THE_ROAD Sullo stesso percorso del punto di riferimento, ma non oltre 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 l'obiettivo è entro i suoi limiti.