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.
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 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.

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.
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 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.