Geocoder

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Classe Geocoder

google.maps.Geocoder classe

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

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>
Geocodificare 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 del codice geografico. È necessario fornire un'unica opzione di address, location e placeId.
bounds optional
LatLngBounds in cui effettuare la ricerca. (Facoltativo)
componentRestrictions optional
I componenti vengono utilizzati per limitare i risultati a un'area specifica. Un filtro è costituito da uno o più: 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 di corrispondenza parziale di altre richieste di geocodifica. (Facoltativo)
language optional
Tipo: string optional
Un identificatore della lingua 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 la ricerca. Il geocodificatore esegue la geocodifica inversa. Per ulteriori informazioni, consulta la sezione Geocodifica inversa. È necessario fornire un'unica opzione di address, location e placeId.
placeId optional
Tipo: string optional
L'ID luogo associato alla sede. 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 la geocodifica inversa. Per ulteriori informazioni, consulta la sezione Geocodifica inversa. È necessario fornire un'unica opzione di address, location e placeId.
region optional
Tipo: string optional
Codice paese utilizzato per eseguire il bias della ricerca, specificato come sottoregione Unicode di 2 caratteri (non numerico)/identificatore CLDR. (Facoltativo) Consulta i dettagli sulla copertura di Google Maps Platform per le aree supportate.

Interfaccia GeocoderComponentRestrictions

google.maps.GeocoderComponentRestrictions interfaccia

GeocoderComponentRestrictions rappresenta un insieme di filtri che si applicano a un'area specifica. Per informazioni dettagliate su come funziona, consulta la sezione Filtro dei componenti di geocodifica.

administrativeArea optional
Tipo: string optional
Corrisponde a tutti e administrative_area levels. (Facoltativo)
country optional
Tipo: string optional
Corrisponde al nome di un 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
Corrisponde a postal_code e postal_code_prefix. (Facoltativo)
route optional
Tipo: string optional
Corrisponde al nome lungo o breve di route. (Facoltativo)

Costanti di GeocoderStatus

google.maps.GeocoderStatus costanti

Lo stato restituito da Geocoder al termine di una chiamata a geocode(). Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'OK' o google.maps.GeocoderStatus.OK.

ERROR Si è verificato un problema durante il contatto con i server di Google.
INVALID_REQUEST 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. Se provi nuovamente, la richiesta potrebbe avere esito positivo.
ZERO_RESULTS Nessun risultato per GeocoderRequest.

Interfaccia GeocoderResponse

google.maps.GeocoderResponse interfaccia

Una risposta Geocoder 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 geocodificata può restituire più oggetti risultato. Tieni presente che, anche se questo risultato è "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 sede. 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 indicano il tipo di elemento geocodificato restituito. Per un elenco delle possibili stringhe, consulta la sezione Tipi di componenti 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 è riuscita a trovare una corrispondenza con una parte dell'indirizzo richiesto. Se viene trovata 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 indicano tutte le località contenute in un codice postale. È presente solo quando il risultato è un codice postale che contiene più località.

Interfaccia GeocoderAddressComponent

google.maps.GeocoderAddressComponent interfaccia

Un singolo componente di indirizzo all'interno di GeocoderResult. Un indirizzo completo può essere costituito da più componenti indirizzo.

long_name
Tipo: string
Il testo completo del componente dell'indirizzo
short_name
Tipo: string
Il testo breve e abbreviato del componente dell'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

google.maps.GeocoderGeometry interfaccia

Informazioni di geometria relative a GeocoderResult

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

Costanti di GeocoderLocationType

google.maps.GeocoderLocationType costanti

Descrive il tipo di località restituita da un codice geografico. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'ROOFTOP' o google.maps.GeocoderLocationType.ROOFTOP.

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 (regione).
RANGE_INTERPOLATED Il risultato restituito riflette un'approssimazione (generalmente su una strada) interpolata tra due punti precisi (come incroci). In genere i risultati interpolati vengono restituiti quando i codici geografici panoramici non sono disponibili per un indirizzo.
ROOFTOP Il risultato restituito riflette una geocodifica esatta.