Geocoder

Classe Geocoder

google.maps.Geocoder libreria di
classi "geocoding"

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

const {Geocoder} = await google.maps.importLibrary("geocoding");

Costruttore
Geocoder	Geocoder() Parametri: nessuno Crea una nuova istanza di un Geocoder che invia richieste di geocodifica ai server di Google.

Metodi
geocode	geocode(request[, callback]) Parametri: request: GeocoderRequest callback: function(Array<GeocoderResult> optional, GeocoderStatus): void optional Valore restituito: Promise<GeocoderResponse> Geocodifica una richiesta.

Interfaccia GeocoderRequest

Interfaccia google.maps.GeocoderRequest

La specifica di una richiesta di geocodifica da inviare a Geocoder.

Proprietà
address facoltativo	Tipo: string optional Indirizzo da geocodificare. È necessario fornire uno, e solo uno, tra address, location e placeId.
bounds facoltativo	Tipo: LatLngBounds|LatLngBoundsLiteral optional LatLngBounds in cui eseguire la ricerca. Facoltativo.
componentRestrictions facoltativo	Tipo: GeocoderComponentRestrictions 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.
extraComputations facoltativo	Avviso: disponibile solo nel canale beta. 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 facoltativo	Tipo: boolean optional Soddisfa la promessa su uno stato ZERO_RESULT nella risposta. Questo potrebbe essere utile perché, anche con zero risultati di geocodifica, potrebbero essere restituiti campi aggiuntivi a livello di risposta.
language facoltativo	Tipo: string optional Un identificatore della lingua in cui devono essere restituiti i risultati, se possibile. Consulta l'elenco delle lingue supportate.
location facoltativo	Tipo: LatLng|LatLngLiteral optional LatLng (o LatLngLiteral) da cercare. Il geocodificatore esegue una geocodifica inversa. Per saperne di più, consulta Geocodifica inversa. È necessario fornire uno, e solo uno, tra address, location e placeId.
placeId facoltativo	Tipo: string optional L'ID luogo associato alla località. Gli ID luogo identificano in modo unico 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 Geocodifica inversa. È necessario fornire uno, e solo uno, tra address, location e placeId.
region facoltativo	Tipo: string optional Codice paese utilizzato per influenzare la ricerca, specificato come identificatore CLDR/subtag di regione Unicode di due caratteri (non numerici). Facoltativo. Per le regioni supportate, consulta i dettagli sulla copertura di Google Maps Platform.

Interfaccia GeocoderComponentRestrictions

Interfaccia google.maps.GeocoderComponentRestrictions

GeocoderComponentRestrictions rappresenta un insieme di filtri che si risolvono in un'area specifica. Per maggiori dettagli su come funziona, consulta Filtro dei componenti di geocodifica.

Proprietà
administrativeArea facoltativo	Tipo: string optional Corrisponde a tutti i administrative_area levels. Facoltativo.
country facoltativo	Tipo: string optional Corrisponde a un nome di paese o a un codice paese ISO 3166-1 di due lettere. Facoltativo.
locality facoltativo	Tipo: string optional Corrisponde ai tipi locality e sublocality. Facoltativo.
postalCode facoltativo	Tipo: string optional Corrisponde a postal_code e postal_code_prefix. Facoltativo.
route facoltativo	Tipo: string optional Corrisponde al nome lungo o breve di un route. Facoltativo.

Costanti ExtraGeocodeComputation

google.maps.ExtraGeocodeComputation libreria di costanti
"geocoding"

Avviso: disponibile solo nel canale beta.

Calcoli aggiuntivi da eseguire durante il completamento di una richiesta di geocodifica.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo ExtraGeocodeComputationString.

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding");

Costanti
ADDRESS_DESCRIPTORS	Genera un descrittore dell'indirizzo.

Costanti GeocoderStatus

google.maps.GeocoderStatus libreria di costanti
"geocoding"

Lo stato restituito da Geocoder al completamento di una chiamata a geocode(). Specifica questi valori in base al valore o utilizzando il nome della costante. Ad esempio: 'OK' o google.maps.GeocoderStatus.OK.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo GeocoderStatusString.

const {GeocoderStatus} = await google.maps.importLibrary("geocoding");

Costanti
ERROR	Si è verificato un problema durante la connessione ai server di Google.
INVALID_REQUEST	Questo GeocoderRequest non era 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 trovato per GeocoderRequest.

Interfaccia GeocoderResponse

Interfaccia google.maps.GeocoderResponse

Una risposta del geocodificatore restituita da Geocoder contenente l'elenco di GeocoderResult.

Proprietà
results	Tipo: Array<GeocoderResult> L'elenco di GeocoderResult.
address_descriptor facoltativo	Avviso: disponibile solo nel canale beta. 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 è abilitato.
plus_code facoltativo	Tipo: PlacePlusCode optional Il Plus Code associato alla località.

Interfaccia GeocoderResult

Interfaccia google.maps.GeocoderResult

Un singolo risultato del geocodificatore recuperato dal server di geocodifica. Una richiesta di geocodifica può restituire più oggetti risultato. Tieni presente che, sebbene questo risultato sia "simile a JSON", non è strettamente JSON, in quanto include indirettamente un oggetto LatLng.

Proprietà
address_components	Tipo: Array<GeocoderAddressComponent> Un array di GeocoderAddressComponent
formatted_address	Tipo: string Una stringa contenente l'indirizzo leggibile di questa località.
geometry	Tipo: GeocoderGeometry Un oggetto GeocoderGeometry
place_id	Tipo: string L'ID luogo associato alla località. Gli ID luogo identificano in modo unico 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 delle possibili stringhe, consulta la sezione Tipi di componenti degli indirizzi della Guida per gli sviluppatori.
address_descriptor facoltativo	Avviso: disponibile solo nel canale beta. 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 le richieste di geocodifica diretta e di ricerca dell'ID luogo, solo quando ExtraGeocodeComputation.ADDRESS_DESCRIPTORS è abilitato e solo per determinati luoghi localizzati.
partial_match facoltativo	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. In caso di corrispondenza esatta, il valore sarà undefined.
plus_code facoltativo	Tipo: PlacePlusCode optional Il Plus Code associato alla località.
postcode_localities facoltativo	Tipo: Array<string> optional Un array di stringhe che indica tutte le località contenute in un codice postale. Questo campo è presente solo quando il risultato è un codice postale che contiene più località.

Interfaccia AddressDescriptor

Interfaccia google.maps.AddressDescriptor

Avviso: disponibile solo nel canale beta.

Una descrizione relazionale di una località. Include un insieme classificato di punti di riferimento nelle vicinanze e le aree contenenti la località target.

Proprietà
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

Interfaccia google.maps.GeocoderAddressComponent

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

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

Interfaccia google.maps.GeocoderGeometry

Informazioni sulla geometria di questo GeocoderResult

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

Costanti GeocoderLocationType

google.maps.GeocoderLocationType libreria di costanti
"geocoding"

Descrive il tipo di località restituito da un geocodice. Specifica questi valori in base al valore o utilizzando il nome della costante. Ad esempio: 'ROOFTOP' o google.maps.GeocoderLocationType.ROOFTOP.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo GeocoderLocationTypeString.

const {GeocoderLocationType} = await google.maps.importLibrary("geocoding");

Costanti
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 (una regione).
RANGE_INTERPOLATED	Il risultato restituito riflette un'approssimazione (di solito su una strada) interpolata tra due punti precisi (ad esempio gli incroci). In genere, i risultati interpolati vengono restituiti quando i geocodici di tipo ROOFTOP non sono disponibili per un indirizzo.
ROOFTOP	Il risultato restituito riflette un geocodice preciso.

Interfaccia Landmark

Interfaccia google.maps.Landmark

Avviso: disponibile solo nel canale beta.

Un luogo che rappresenta un punto di riferimento per l'indirizzo.

Proprietà
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 ottenere ulteriori informazioni sul punto di riferimento tramite Place Details o Place Id Lookup.
spatial_relationship	Tipo: SpatialRelationship Definisce la relazione spaziale tra la località target e il punto di riferimento.
straight_line_distance_meters	Tipo: number La distanza in linea retta tra la località target 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 facoltativo	Tipo: number optional La distanza di percorrenza lungo la rete stradale tra la località target e il punto di riferimento. Questo campo può essere vuoto se il punto di riferimento è scollegato dalla parte della rete stradale più vicina alla destinazione OPPURE se la località target non è stata effettivamente considerata parte della rete stradale.

Interfaccia Area

Interfaccia google.maps.Area

Avviso: disponibile solo nel canale beta.

Un luogo che è una piccola regione, ad esempio un quartiere, una località secondaria o un grande complesso che contiene la località target.

Proprietà
containment	Tipo: Containment Definisce la relazione spaziale tra la località 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 ottenere ulteriori informazioni sull'area tramite Place Details o Place ID Lookup.

Costanti di contenimento

google.maps.Containment libreria di costanti
"geocoding"

Avviso: disponibile solo nel canale beta.

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

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo ContainmentString.

const {Containment} = await google.maps.importLibrary("geocoding");

Costanti
NEAR	La località target 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 confine.
WITHIN	La località target si trova all'interno della regione dell'area, vicino al centro.

Costanti SpatialRelationship

google.maps.SpatialRelationship libreria di costanti
"geocoding"

Avviso: disponibile solo nel canale beta.

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

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo SpatialRelationshipString.

const {SpatialRelationship} = await google.maps.importLibrary("geocoding");

Costanti
ACROSS_THE_ROAD	Il target si trova esattamente di fronte al punto di riferimento, sull'altro lato della strada.
AROUND_THE_CORNER	Non si trova 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	La destinazione è direttamente adiacente 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 nessuna delle relazioni più specifiche riportate di seguito.
WITHIN	Il punto di riferimento ha una geometria spaziale e la destinazione si trova all'interno dei suoi confini.