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

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