Geocoder

lezione Geocoder

lezione google.maps.Geocoder

Un servizio di conversione tra un indirizzo e un LatLng.

Quando usi v=beta, puoi accedervi chiamando const {Geocoder} = await google.map.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 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
L'indirizzo per la geocodifica. È necessario indicare una sola opzione, ovvero 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ù tra: 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 di altre richieste di geocodifica. (Facoltativo)
language optional
Tipo: string optional
L'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 cui cercare. Il geocodificatore esegue una geocodifica inversa. Per ulteriori informazioni, consulta la pagina Reverse Geocoding. È necessario indicare una sola opzione, ovvero address, location e placeId.
placeId optional
Tipo: string optional
L'ID del 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 una geocodifica inversa. Per ulteriori informazioni, consulta la sezione Codifica geografica inversa. È necessario indicare una sola opzione, ovvero address, location e placeId.
region optional
Tipo: string optional
Codice paese utilizzato per polizzare la ricerca, specificato come sottotag di regione Unicode / identificatore CLDR di due caratteri (non numerico). (Facoltativo) Consulta i dettagli di copertura di Google Maps Platform per le regioni supportate.

Interfaccia GeocoderComponentRestrictions

google.maps.GeocoderComponentRestrictions interfaccia

GeocoderComponentRestrictions rappresenta un insieme di filtri che si risolvono in un'area specifica. Per informazioni dettagliate su questa procedura, consulta la sezione Filtro dei componenti di geocodifica.

administrativeArea optional
Tipo: string optional
Corrisponde a tutti i 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 al numero geocode(). Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'OK' o google.maps.GeocoderStatus.OK.

Quando usi v=beta, puoi accedervi chiamando const {GeocoderStatus} = await google.map.importLibrary("geocoding"). Consulta la sezione Librerie nell'API Maps JavaScript.

ERROR Si è verificato un problema durante la connessione ai server di Google.
INVALID_REQUEST Questa GeocoderRequest non era valida.
OK La risposta contiene un elemento 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 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 geocodifica recuperato dal server di geocodifica. Una richiesta di geocodifica può restituire più oggetti risultato. Anche se il risultato è "simile a JSON", non è strettamente JSON perché include indirettamente un oggetto LatLng.

address_components
Un array di GeocoderAddressComponent s
formatted_address
Tipo: string
Una stringa contenente l'indirizzo leggibile di questo luogo.
geometry
Un oggetto GeocoderGeometry
place_id
Tipo: string
L'ID del 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 degli indirizzi 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 far corrispondere parte dell'indirizzo richiesto. Se si tratta di una corrispondenza esatta, il valore è 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

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 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 indirizzo. Puoi trovare un elenco dei tipi validi qui

Interfaccia GeocoderGeometry

google.maps.GeocoderGeometry interfaccia

Informazioni di geometria relative a questo 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 elemento GeocoderResult
bounds optional
Tipo: LatLngBounds optional
I limiti precisi di questo elemento GeocoderResult, se applicabile

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

Quando usi v=beta, puoi accedervi chiamando const {GeocoderLocationType} = await google.map.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. strada) o un poligono (area geografica).
RANGE_INTERPOLATED Il risultato restituito riflette un'approssimazione (generalmente su una strada) interpolata tra due punti precisi (come degli incroci). I risultati interpolati vengono generalmente restituiti se non sono disponibili i codici geografici panoramici per un indirizzo.
ROOFTOP Il risultato restituito riflette un codice geografico preciso.