Package google.maps.geocode.v4alpha

Indice

DestinationService

Un servizio per il recupero delle destinazioni.

Una destinazione fornisce un contesto gerarchico su un luogo, il che ti consente, ad esempio, di trovare condomini all'interno di un complesso di appartamenti più grande e viceversa. Fornisce inoltre punti di navigazione adatti a casi d'uso come il ridesharing o la consegna.

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

Questo metodo esegue una ricerca della destinazione e restituisce un elenco di destinazioni.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode

GeocodeService

Un servizio per eseguire la geocodifica.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

Questo metodo esegue una geocodifica dell'indirizzo, che mappa un indirizzo in un LatLng. Fornisce anche informazioni strutturate sull'indirizzo.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address
GeocodeLocation

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

Questo metodo esegue una geocodifica della posizione, che mappa un LatLng a un indirizzo. Fornisce anche informazioni strutturate sull'indirizzo.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location
GeocodePlace

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

Questo metodo esegue una ricerca di geocodifica utilizzando un ID luogo.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.place

Destinazione

Una destinazione. Sono inclusi il luogo principale, i luoghi correlati, gli ingressi e i punti di navigazione.

Campi
primary

PlaceView

Il luogo principale identificato da primary_query nella richiesta.
containing_places[]

PlaceView

I luoghi meno precisi in cui è contenuta la località principale. Ad esempio, il complesso di appartamenti che contiene questo edificio.
sub_destinations[]

PlaceView

Destinazioni secondarie più precise del luogo principale. Ad esempio, le unità contenute in un edificio.

Nota: rispetto alla SubDestination restituita dall'API Places, questo elenco di sottodestinazioni è più esaustivo e ogni sottodestinazione contiene più informazioni.
landmarks[]

Landmark

Punti di riferimento che possono essere utilizzati per comunicare la posizione della destinazione o per facilitare l'arrivo.
entrances[]

Entrance

Ingressi per questa destinazione.
navigation_points[]

NavigationPoint

Punti di navigazione per questa destinazione.
arrival_summary

Destination.ArrivalSummary

Riepilogo dell'esperienza di arrivo a destinazione creato con l'AI.

ArrivalSummary

Riepilogo dell'esperienza di arrivo a destinazione creato con l'AI.

Campi
text

LocalizedText

Il riepilogo dell'esperienza di arrivo a destinazione.
flag_content_url

string

Un link in cui gli utenti possono segnalare un problema con il riepilogo.
disclosure_text

LocalizedText

Solo output. Contiene il testo dell'informativa per il riepilogo dell'arrivo.

Ingresso

Un ingresso è una singola coppia di coordinate di latitudine/longitudine che definisce la posizione di un punto di ingresso e di uscita per un luogo.

Campi
location

LatLng

La posizione dell'ingresso.
tags[]

Entrance.Tag

Un elenco di tag che descrivono l'ingresso.
place

string

La struttura su cui si trova fisicamente questo ingresso, in formato places/{place_id}.

Tag

Caratteristiche che descrivono un ingresso.

Enum
TAG_UNSPECIFIED Non utilizzato.
PREFERRED

L'ingresso probabilmente fornisce l'accesso fisico al luogo principale della destinazione restituita. Un luogo può avere più ingressi preferiti. Se un ingresso non ha questo tag, significa che si trova fisicamente nello stesso edificio del luogo principale, ma non fornisce necessariamente l'accesso al luogo.

Ad esempio, se il luogo principale è un ristorante in un centro commerciale, gli ingressi "PREFERITI" saranno quelli che probabilmente conducono al ristorante stesso, mentre gli altri ingressi restituiti saranno altri ingressi dell'edificio, ad esempio quelli di altri ristoranti del centro commerciale.

Se il luogo principale è un edificio, gli ingressi PREFERRED saranno quelli che conducono alla parte "principale" dell'edificio. Ad esempio, in un centro commerciale gli ingressi PREFERRED saranno quelli che consentono l'accesso all'atrio principale, ma se un ingresso fornisce l'accesso solo a un negozio sul lato dell'edificio, non sarà un ingresso PREFERRED.

Nota: un ingresso PREFERRED potrebbe non fornire l'accesso al luogo principale, mentre un ingresso non PREFERRED potrebbe fornire l'accesso al luogo principale.

GeocodeAddressRequest

Messaggio di richiesta per GeocodeService.GeocodeAddress.

Campi
location_bias

GeocodeAddressRequest.LocationBias

Facoltativo. La regione in cui eseguire la ricerca. Questa posizione funge da bias, il che significa che potrebbero essere restituiti risultati intorno alla posizione specificata.
language_code

string

Facoltativo. Lingua in cui devono essere restituiti i risultati.
region_code

string

Facoltativo. Codice regione. Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Il parametro influisce sui risultati in base alla legge vigente. Questo parametro influenzerà anche i risultati del servizio, ma non li limiterà completamente.
Campo unione address_input. L'indirizzo da geocodificare. address_input può essere solo uno dei seguenti tipi:
address_query

string

L'indirizzo non strutturato da geocodificare.
address

PostalAddress

L'indirizzo strutturato da geocodificare nel formato di indirizzo postale.

LocationBias

La regione in cui eseguire la ricerca. Questa posizione funge da bias, il che significa che potrebbero essere restituiti risultati intorno alla posizione specificata.

Campi
Campo unione type. Tipi di distorsione della località. type può essere solo uno dei seguenti tipi:
rectangle

Viewport

Un rettangolo definito dagli angoli nord-est e sud-ovest. rectangle.high() deve essere il punto nord-est del riquadro di visualizzazione rettangolare. rectangle.low() deve essere il punto sud-ovest del riquadro di visualizzazione rettangolare. rectangle.low().latitude() non può essere maggiore di rectangle.high().latitude(). Verrà generato un intervallo di latitudine vuoto. Un riquadro rettangolare non può essere più ampio di 180 gradi.

GeocodeAddressResponse

Messaggio di risposta per GeocodeService.GeocodeAddress.

Campi
results[]

GeocodeResult

Il risultato della geocodifica.

GeocodeLocationRequest

Messaggio di richiesta per GeocodeService.GeocodeLocation.

Campi
language_code

string

Facoltativo. Lingua in cui devono essere restituiti i risultati.
region_code

string

Facoltativo. Codice regione. Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Il parametro influisce sui risultati in base alla legge vigente.
types[]

string

Facoltativo. Un insieme di tag di tipo per limitare i risultati. I risultati che non hanno nessuno dei tipi specificati vengono rimossi.

Per l'elenco completo dei valori possibili, consulta la tabella A e la tabella B all'indirizzo https://developers.google.com/maps/documentation/places/web-service/place-types.
granularity[]

GeocodeResult.Granularity

Facoltativo. Un filtro di una o più enumerazioni di granularità della posizione.
Campo unione location_input. La posizione da geocodificare. location_input può essere solo uno dei seguenti tipi:
location_query

string

La posizione nel formato della stringa "lat,lng". Ad esempio, "64.7611872,-18.4705364".
location

LatLng

La posizione nel formato strutturato.

GeocodeLocationResponse

Messaggio di risposta per GeocodeService.GeocodeLocation.

Campi
results[]

GeocodeResult

Il risultato della geocodifica.
plus_code

PlusCode

Il Plus Code della località nella richiesta.

GeocodePlaceRequest

Messaggio di richiesta per GeocodeService.GeocodePlace.

Campi
place

string

Obbligatorio. Identificatore del luogo da geocodificare nel formato places/{place}.
language_code

string

Facoltativo. Lingua in cui devono essere restituiti i risultati.
region_code

string

Facoltativo. Codice regione. Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Il parametro influisce sui risultati in base alla legge vigente.

GeocodeResult

Un risultato di geocodifica contiene informazioni geografiche su un luogo.

Campi
place

string

L'identificatore completo del luogo per questo risultato. Nel formato "//places.googleapis.com/places/{placeID}". Per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/place-id.
place_id

string

L'ID luogo per questo risultato.
location

LatLng

Le coordinate lat/lng di questo indirizzo.
granularity

GeocodeResult.Granularity

La granularità della posizione.
viewport

Viewport

Un'area visibile adatta alla visualizzazione del risultato di geocodifica.
bounds

Viewport

Un riquadro di delimitazione per l'indirizzo.
formatted_address

string

L'indirizzo formattato su una riga.
postal_address

PostalAddress

L'indirizzo nel formato dell'indirizzo postale.
address_components[]

GeocodeResult.AddressComponent

Componenti ripetuti per ogni livello di località.
postal_code_localities[]

LocalizedText

Elenco completo delle località contenute nel codice postale.

Questo campo viene compilato solo quando il risultato è di tipo "postal_code".
types[]

string

Un insieme di tag di tipo per questo risultato. Ad esempio, "political" e "administrative_area".

Per l'elenco completo dei valori possibili, consulta la tabella A e la tabella B all'indirizzo https://developers.google.com/maps/documentation/places/web-service/place-types.
plus_code

PlusCode

Plus Code della posizione in questo geocodice.

AddressComponent

I componenti strutturati che formano l'indirizzo formattato, se queste informazioni sono disponibili.

Campi
long_text

string

La descrizione o il nome completo del componente dell'indirizzo. Ad esempio, un componente dell'indirizzo per il paese Australia potrebbe avere il nome lungo "Australia".
short_text

string

Un nome testuale abbreviato per il componente dell'indirizzo, se disponibile. Ad esempio, un componente dell'indirizzo per il paese Australia potrebbe avere il nome breve "AU".
types[]

string

Un array che indica il tipo o i tipi di componente dell'indirizzo.

Per maggiori dettagli, consulta la pagina https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types.
language_code

string

La lingua utilizzata per formattare questi componenti, nella notazione CLDR.

Granularità

La granularità della posizione.

Enum
GRANULARITY_UNSPECIFIED Non utilizzare.
ROOFTOP La posizione non interpolata di un appezzamento di terreno effettivo corrispondente all'indirizzo trovato.
RANGE_INTERPOLATED Interpolato da un intervallo di numeri civici. Ad esempio, se sappiamo che un segmento di Amphitheatre Pkwy contiene i numeri 1600-1699, il numero 1650 potrebbe essere posizionato a metà strada tra i suoi punti estremi.
GEOMETRIC_CENTER Il centro geometrico di una funzionalità per cui disponiamo di dati poligonali.
APPROXIMATE Tutto il resto.

Punto di riferimento

I punti di riferimento vengono utilizzati per comunicare dove si trova la destinazione o per aiutare ad arrivarci.

Campi
relational_description

LocalizedText

Una descrizione leggibile di come la destinazione è correlata al punto di riferimento. Ad esempio: "Vicino all'Empire State Building" o "Di fronte alla Casa Bianca".
tags[]

Landmark.Tag

Tag che descrivono come può essere utilizzato il punto di riferimento nel contesto della destinazione.
straight_line_distance_meters

double

Solo output. La distanza in linea retta da questo punto di riferimento alla destinazione in metri.
travel_distance_meters

double

Solo output. La distanza dalla rete stradale da questo punto di riferimento alla destinazione in metri.
Campo unione landmark. Il punto di riferimento. landmark può essere solo uno dei seguenti tipi:
place

PlaceView

Il luogo che rappresenta questo punto di riferimento.

Tag

L'elenco di tutti i tag possibili che descrivono come può essere utilizzato un punto di riferimento nel contesto di una destinazione.

Se un indirizzo ha entrambi i tag ADDRESS e ARRIVAL, significa che il punto di riferimento è sia in evidenza a livello locale sia vicino alla destinazione.

Enum
TAG_UNSPECIFIED Non utilizzato.
ADDRESS Un luogo di rilievo locale che può essere utilizzato per identificare la posizione generale della destinazione. In genere entro poche centinaia di metri dalla destinazione. Questi sono simili ai punti di riferimento restituiti dalla funzionalità Descrittori di indirizzi dell'API Geocoding: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL Un luogo che può essere utilizzato per raggiungere la destinazione. Utile per la navigazione quando ti trovi nelle vicinanze della destinazione. Ad esempio, questo punto di riferimento potrebbe essere un luogo che si trova di fronte alla destinazione. Un punto di riferimento con questo tag è in genere più vicino alla destinazione rispetto ai punti di riferimento con il tag ADDRESS.

Un punto di navigazione è una posizione accanto a una strada in cui può terminare la navigazione.

Campi
navigation_point_token

string

Solo output. Un token che può essere utilizzato per identificare questo punto di navigazione.
display_name

LocalizedText

Il nome visualizzato di questo punto di navigazione. Ad esempio, "5th Ave" o "Gate B".
location

LatLng

Un punto accanto al tratto di strada in cui deve terminare la navigazione. Il punto è intenzionalmente leggermente spostato rispetto alla linea centrale della strada per indicare chiaramente il lato della strada in cui si trova il luogo.
travel_modes[]

NavigationPoint.TravelMode

Modalità di viaggio appropriate per questo punto di navigazione.
usages[]

NavigationPoint.Usage

Utilizzi supportati da questo punto di navigazione.

TravelMode

Modalità di viaggio appropriate per questo punto di navigazione.

Enum
TRAVEL_MODE_UNSPECIFIED Non utilizzato.
DRIVE Adatto alla guida.
WALK Adatto per le camminate.

Utilizzo

Utilizzi supportati da questo punto di navigazione.

Enum
USAGE_UNSPECIFIED Non utilizzato.
UNKNOWN Tipo di utilizzo sconosciuto. La maggior parte dei punti di navigazione sarà UNKNOWN e ciò non significa necessariamente che il loro utilizzo sia limitato in alcun modo. Questo percorso potrebbe essere comunque adatto per il ritiro e/o la consegna.
DROPOFF Adatto per far scendere un passeggero. Ad esempio, un punto di consegna per il servizio di ridesharing.
PICKUP Adatto per prendere a bordo un passeggero. Ad esempio, un punto di ritiro del ridesharing.

PlaceView

Rappresenta una visualizzazione di un luogo nell'API Places. Fornisce inoltre informazioni aggiuntive specifiche per le destinazioni, come il tipo di struttura e il poligono di visualizzazione.

In alcuni casi, un PlaceView con lo stesso ID luogo potrebbe differire da ciò che viene restituito dall'API Places per i campi types e display_name.

Campi
place

string

Il nome della risorsa di questo luogo, nel formato places/{placeId}.
display_name

LocalizedText

Descrizione del luogo leggibile. Ad esempio, "Gate B", "McDonalds"
primary_type

string

Il tipo di luogo principale di questo luogo. Per l'elenco dei valori possibili, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/place-types.

Nota: questo campo non viene sempre compilato. In queste situazioni, preparati a utilizzare il campo types.
types[]

string

Tutti i tipi di luoghi associati a questo luogo. Per l'elenco dei valori possibili, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/place-types.
formatted_address

string

Indirizzo su una riga.
postal_address

PostalAddress

Indirizzo strutturato.
structure_type

PlaceView.StructureType

Il tipo di struttura corrispondente a questo luogo.
location

LatLng

La posizione di questo luogo. Per i luoghi con poligoni di visualizzazione, questo può rappresentare un buon punto per posizionare un indicatore sulla mappa.
display_polygon

Struct

Il contorno poligonale del luogo in formato GeoJSON, utilizzando il formato RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

Nota: il formato RFC 7946 supporta i MultiPolygon, quindi un oggetto display_polygon può rappresentare più poligoni.

StructureType

Il tipo di struttura rappresentato da questo luogo.

Enum
STRUCTURE_TYPE_UNSPECIFIED Non utilizzato.
POINT Una posizione puntuale.
SECTION Una sottosezione di un edificio.
BUILDING Un edificio.
GROUNDS Un'area di grandi dimensioni che in genere contiene più edifici, come un campus universitario, un complesso di appartamenti o un centro commerciale.

PlusCode

Il Plus Code (http://plus.codes) è un riferimento di posizione con due formati: codice globale che definisce un rettangolo di 14 m x 14 m (1/8000 di grado) o più piccolo e codice composto, che sostituisce il prefisso con una posizione di riferimento.

Campi
global_code

string

Il codice globale (completo) del luogo, ad esempio "9FWM33GV+HQ ", che rappresenta un'area di 1/8000 di grado per 1/8000 di grado (~14 x 14 metri).
compound_code

string

Il codice composto del luogo, ad esempio "33GV+HQ, Ramberg, Norvegia ", contenente il suffisso del codice globale e sostituendo il prefisso con il nome formattato di un'entità di riferimento.

SearchDestinationsRequest

Messaggio di richiesta per DestinationService.SearchDestinations.

Campi
travel_modes[]

NavigationPoint.TravelMode

Facoltativo. Le modalità di viaggio per cui filtrare i punti di navigazione. Ciò influisce sul campo navigation_points restituito nella risposta. Se è vuoto, possono essere restituiti i punti di navigazione di tutte le modalità di viaggio.
language_code

string

Facoltativo. Lingua in cui devono essere restituiti i risultati.
region_code

string

Facoltativo. Codice regione. Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Il parametro influisce sui risultati in base alla legge vigente. Questo parametro influenza anche, ma non limita completamente, i risultati del servizio.

Campo unione primary_query. Esegui una query per la destinazione principale. Può trattarsi di un luogo, di un indirizzo specificato in modo completo o di una posizione LatLng. Alcuni luoghi e indirizzi con informazioni minime non potranno essere trasformati in una destinazione.

Le destinazioni sono create in base alla query principale specificata.

Nota: sono supportati solo i luoghi e gli indirizzi che possono avere una destinazione di navigazione. Ad esempio, un luogo che rappresenta una casa o un complesso di appartamenti può essere utilizzato come query principale, ma i luoghi che rappresentano una località o un'area amministrativa non possono essere utilizzati come query principale. primary_query può essere solo uno dei seguenti tipi:
place

string

Il nome risorsa di un luogo, nel formato places/{place_id}.
address_query

SearchDestinationsRequest.AddressQuery

Indirizzo e numero civico.
location_query

SearchDestinationsRequest.LocationQuery

Una posizione esatta.

AddressQuery

L'indirizzo della via che vuoi cercare. Specifica gli indirizzi in conformità al formato utilizzato dal servizio postale nazionale del paese interessato.

Campi
Campo unione kind. La query dell'indirizzo. kind può essere solo uno dei seguenti tipi:
address

PostalAddress

Un indirizzo e numero civico nel formato dell'indirizzo postale.
address_query

string

Un indirizzo formattato come una singola riga.

LocationQuery

Una query sulla posizione per identificare una destinazione principale nelle vicinanze.

Nota: se la query sulla posizione si trova all'interno di un edificio che contiene locali secondari, è possibile che il luogo principale restituito sia un locale secondario. In questi casi, il campo containing_places includerà l'edificio.

Campi
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

Facoltativo. Filtri da applicare alle destinazioni candidate.
Campo unione kind. La query sulla posizione. kind può essere solo uno dei seguenti tipi:
location

LatLng

Una posizione LatLng esatta.

PlaceFilter

Filtri da applicare alle destinazioni candidate.

Campi
structure_type

PlaceView.StructureType

Facoltativo. Se specificate, tutte le destinazioni hanno la garanzia di avere un luogo principale con questo tipo di struttura. Ciò può comportare il filtraggio di alcune destinazioni o l'affinamento/l'approssimazione delle destinazioni restituite.

Ad esempio, se viene specificato GROUNDS, tutte le destinazioni restituite avranno un luogo principale con il tipo di struttura GROUNDS. Ciò può comportare il filtraggio di alcune destinazioni che non fanno parte di un terreno o l'approssimazione delle destinazioni restituite al livello del terreno.

Un altro utilizzo di questo campo è l'estrazione più semplice dei poligoni di visualizzazione degli edifici. Ad esempio, se viene specificato BUILDING, il poligono di visualizzazione del luogo principale sarà quello dell'edificio nella posizione specificata.
addressability

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

Facoltativo. Se specificato, restituisce solo le destinazioni che soddisfano i criteri di indirizzabilità corrispondenti.

Indirizzabilità

Definisce le opzioni per il filtro di indirizzabilità. In futuro potrebbero essere aggiunti nuovi valori.

Enum
ADDRESSABILITY_UNSPECIFIED Se non specificato, il servizio sceglierà un valore predefinito ragionevole.
ANY L'indirizzabilità non è un criterio di filtro. Le destinazioni vengono restituite indipendentemente dalla loro indirizzabilità.
PRIMARY Tutte le destinazioni restituite avranno un luogo principale con un indirizzo o un nome a livello di strada.
WEAK Tutte le destinazioni restituite avranno un luogo principale o una sottodestinazione con un indirizzo o un nome a livello di strada.

SearchDestinationsResponse

Messaggio di risposta per DestinationService.SearchDestinations.

Campi
destinations[]

Destination

Un elenco di destinazioni.

Il servizio restituisce un risultato se una destinazione principale può essere identificata in modo univoco dalla query principale. In caso contrario, il servizio potrebbe restituire più risultati per la disambiguazione o nessun risultato.