Package google.maps.geocode.v4alpha

Indice

• DestinationService (interfaccia)
• GeocodeService (interfaccia)
• Destination (messaggio)
• Destination.ArrivalSummary (messaggio)
• Destination.ParkingOptions (messaggio)
• Destination.ParkingOptions.Availability (enum)
• Destination.ParkingOptions.ParkingFacility (messaggio)
• Entrance (messaggio)
• Entrance.Tag (enum)
• GeocodeAddressRequest (messaggio)
• GeocodeAddressRequest.LocationBias (messaggio)
• GeocodeAddressResponse (messaggio)
• GeocodeLocationRequest (messaggio)
• GeocodeLocationResponse (messaggio)
• GeocodePlaceRequest (messaggio)
• GeocodeResult (messaggio)
• GeocodeResult.AddressComponent (messaggio)
• GeocodeResult.Granularity (enum)
• ImageAnnotation (messaggio)
• ImageAnnotation.Coordinate (messaggio)
• Landmark (messaggio)
• Landmark.Tag (enum)
• NavigationPoint (messaggio)
• NavigationPoint.TravelMode (enum)
• NavigationPoint.Usage (enum)
• PlaceView (messaggio)
• PlaceView.AddressComponent (messaggio)
• PlaceView.StructureType (enum)
• PlusCode (messaggio)
• SearchDestinationsRequest (messaggio)
• SearchDestinationsRequest.AddressQuery (messaggio)
• SearchDestinationsRequest.LocationQuery (messaggio)
• SearchDestinationsRequest.LocationQuery.PlaceFilter (messaggio)
• SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability (enum)
• SearchDestinationsResponse (messaggio)
• StreetViewThumbnail (messaggio)

DestinationService

Un servizio per il recupero delle destinazioni.

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

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse) Questo metodo esegue una ricerca delle destinazioni 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 https://www.googleapis.com/auth/maps-platform.destinations

GeocodeService

Un servizio per l'esecuzione della geocodifica.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse) Questo metodo esegue una geocodifica dell'indirizzo, che mappa un indirizzo a un valore LatLng. Fornisce inoltre 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 località, che mappa un valore LatLng a un indirizzo. Fornisce inoltre 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 che contengono il luogo principale. Ad esempio, il complesso di appartamenti che contiene questo edificio.
sub_destinations[]	PlaceView Sottodestinazioni più precise del luogo principale. Ad esempio, le unità contenute in un edificio. Nota: rispetto al campo SubDestination restituito dall'API Places, questo elenco di destinazioni secondarie è più esaustivo e ogni destinazione secondaria contiene più informazioni.
landmarks[]	Landmark Punti di riferimento che possono essere utilizzati per comunicare dove si trova la destinazione o per facilitare l'arrivo.
entrances[]	Entrance Ingressi per questa destinazione.
navigation_points[]	NavigationPoint Punti di navigazione per questa destinazione.
parking_options	Destination.ParkingOptions Opzioni di parcheggio per questa destinazione.
arrival_summary	Destination.ArrivalSummary Riepilogo creato con l'AI dell'esperienza di arrivo presso la destinazione.

ArrivalSummary

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

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.

ParkingOptions

Informazioni sulle opzioni di parcheggio per la destinazione.

Campi
availability	Destination.ParkingOptions.Availability La disponibilità di parcheggio per questa destinazione.
parking_facilities[]	Destination.ParkingOptions.ParkingFacility I parcheggi per questa destinazione.
onsite_parking	bool È disponibile un parcheggio in loco presso la destinazione.
free_parking_lot	bool Offre parcheggi gratuiti.
paid_parking_lot	bool Offre parcheggi a pagamento.
free_street_parking	bool Offre parcheggio in strada senza costi
paid_street_parking	bool Offre un parcheggio in strada a pagamento.
valet_parking	bool Offre il servizio di ritiro e riconsegna auto.
free_garage_parking	bool Offre il parcheggio in garage incluso nel prezzo.
paid_garage_parking	bool Offre un garage a pagamento.

Disponibilità

Una misura aggregata di quanto sia difficile trovare parcheggio quando si visita questo luogo.

In futuro potrebbero essere aggiunti nuovi valori.

Enum
AVAILABILITY_UNSPECIFIED	La disponibilità di parcheggio non è disponibile.
PLENTY	È disponibile un ampio parcheggio.
SOMEWHAT_DIFFICULT	È abbastanza difficile trovare parcheggio.
DIFFICULT	È molto difficile trovare parcheggio.

ParkingFacility

Un'opzione di parcheggio individuale e distinta (ad es. un parcheggio o un garage specifico) associata alla destinazione. In questo modo vengono fornite informazioni dettagliate su un parcheggio specifico, mentre il messaggio principale ParkingOptions fornisce un riepilogo aggregato di tutti i parcheggi disponibili.

Campi
place	PlaceView La rappresentazione del luogo di questo parcheggio specifico.
onsite	bool Indica se il parcheggio si trova in loco presso la destinazione principale. Se questo campo non è impostato, lo stato on-site è sconosciuto.
popular	bool Indica se questo parcheggio è una scelta popolare per i visitatori che si recano alla destinazione principale. Se questo campo non è impostato, lo stato di popolarità è sconosciuto.
straight_line_distance_meters	double La distanza in linea d'aria in metri dalla destinazione principale a questo parcheggio.

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
display_name	LocalizedText Nome leggibile, ad esempio "Gate B", "Ingresso sud", "Ingresso 5th Ave".
location	LatLng La posizione dell'ingresso.
tags[]	Entrance.Tag Un elenco di tag che descrivono l'ingresso.
place	string La struttura in cui si trova fisicamente l'ingresso, nel formato places/{place_id}.
street_view_thumbnail	StreetViewThumbnail Immagine in miniatura di Street View che mostra l'ingresso. L'immagine può essere richiesta dall'API Street View Static. Consulta la pagina https://developers.google.com/maps/documentation/streetview/request-streetview.
street_view_annotation	ImageAnnotation Annotazione dell'ingresso sul street_view_thumbnail restituito sopra.

Tag

Caratteristiche che descrivono un ingresso.

Enum
TAG_UNSPECIFIED	Non utilizzato.
PREFERRED	L'ingresso probabilmente fornisce l'accesso fisico al luogo principale nella 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 "PREFERRED" 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'area dell'atrio principale, ma se un ingresso consente 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 e 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 località funge da bias, il che significa che i risultati relativi alla località specificata sono preferiti.
language_code	string Facoltativo. La 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, ma non limiterà completamente, i risultati del servizio.
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 dell'indirizzo postale.

LocationBias

La regione in cui eseguire la ricerca. Questa località funge da bias, il che significa che i risultati relativi alla località specificata sono preferiti.

Campi
Campo unione type. Tipi di bias di posizione. type può essere solo uno dei seguenti tipi:
rectangle	Viewport Un riquadro rettangolare definito dall'angolo nord-est e sud-ovest. rectangle.high() deve essere il punto nord-est della finestra visibile rettangolare. rectangle.low() deve essere il punto sud-ovest dell'area visibile rettangolare. rectangle.low().latitude() non può essere maggiore di rectangle.high().latitude(). Ciò comporterà un intervallo di latitudine vuoto. Un'area visibile rettangolare non può essere più larga 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. La 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 uno o più enum di granularità della località.
Campo unione location_input. La località 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 località nel formato strutturato.

GeocodeLocationResponse

Messaggio di risposta per GeocodeService.GeocodeLocation.

Campi
results[]	GeocodeResult Il risultato della geocodifica.
plus_code	PlusCode 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. La 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 Il nome della risorsa di questo luogo, nel formato places/{placeId}. Può essere utilizzato per cercare il luogo.
place_id	string L'identificatore univoco di un luogo.
location	LatLng La latitudine e la longitudine di questo indirizzo.
granularity	GeocodeResult.Granularity La granularità della località.
viewport	Viewport Un'area visibile adatta per visualizzare il risultato della 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 località in questo geocodice.

AddressComponent

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

Campi
long_text	string La descrizione testuale completa o il nome 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 l'Australia potrebbe avere il nome breve "AU".
types[]	string Un array che indica i tipi di componenti dell'indirizzo. Questi valori sono tratti dalla tabella dei tipi di indirizzo e dei tipi di componenti dell'indirizzo utilizzata dall'API Places: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code	string La lingua utilizzata per formattare questo componente, in notazione CLDR.

Granularità

La granularità della località.

Enum
GRANULARITY_UNSPECIFIED	Non utilizzare.
ROOFTOP	La posizione non interpolata di un appezzamento di terreno effettivo corrispondente all'indirizzo corrispondente.
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à tra i suoi endpoint.
GEOMETRIC_CENTER	Il centro geometrico di un elemento per il quale disponiamo di dati poligonali.
APPROXIMATE	Tutto il resto.

ImageAnnotation

Un'annotazione su una miniatura dell'immagine, ad esempio un poligono che delinea un ingresso.

Campi
coordinates[]	ImageAnnotation.Coordinate Un elenco di coordinate che formano un poligono sull'immagine. Le coordinate sono ordinate in senso antiorario.

Coordinate

Coordinata pixel di un punto sull'immagine. L'origine (0,0) è l'angolo in alto a sinistra del pixel in alto a sinistra dell'immagine, con l'asse x rivolto verso destra e l'asse y rivolto verso il basso.

Campi
x_px	float Coordinata X.
y_px	float Coordinata Y.

Punto di riferimento

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

Campi
relational_description	LocalizedText Una descrizione leggibile della relazione tra la destinazione e il punto di riferimento. Ad esempio: "Vicino all'Empire State Building" o "Di fronte alla Casa Bianca".
tags[]	Landmark.Tag Tag che descrivono come il punto di riferimento può essere utilizzato 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 a piedi 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 possibili tag che descrivono come un punto di riferimento può essere utilizzato nel contesto di una destinazione.

Se un indirizzo ha entrambi i tag ADDRESS e ARRIVAL, significa che il punto di riferimento è sia importante 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 generica della destinazione. In genere, entro poche centinaia di metri dalla destinazione. Questi sono simili ai punti di riferimento restituiti dalla funzionalità Descrittori degli 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 sei vicino alla destinazione. Ad esempio, questo punto di riferimento potrebbe essere un luogo che si trova dall'altra parte della strada rispetto alla destinazione. Un punto di riferimento con questo tag è in genere più vicino alla destinazione rispetto ai punti di riferimento con il tag ADDRESS.

NavigationPoint

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

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 Elenca i usages supportati da questo punto di navigazione. Se il campo è vuoto, non significa necessariamente che l'utilizzo sia limitato in qualche modo. Tutti i punti di navigazione possono essere utilizzati per la navigazione generale.
street_view_thumbnail	StreetViewThumbnail Immagine in miniatura di Street View che mostra il punto di navigazione, se disponibile. L'immagine può essere richiesta dall'API Street View Static. Consulta la pagina https://developers.google.com/maps/documentation/streetview/request-streetview.
entrance_annotation	ImageAnnotation Annotazione dell'ingresso associato a questo punto di navigazione sul street_view_thumbnail restituito sopra, se disponibile.
altitude_meters	float L'altitudine del punto di navigazione in metri rispetto all'ellissoide WGS-84.

TravelMode

Modalità di viaggio appropriate per questo punto di navigazione.

Enum
TRAVEL_MODE_UNSPECIFIED	Non utilizzato.
DRIVE	Adatto per la guida.
WALK	Adatto per camminare.

Utilizzo

Utilizzi supportati da questo punto di navigazione. In futuro potrebbero essere aggiunti nuovi valori.

Enum
USAGE_UNSPECIFIED	Non utilizzato.
UNKNOWN	Indica che il tipo di utilizzo è sconosciuto.
DROPOFF	Adatto per far scendere un passeggero. Ad esempio, un punto di arrivo per il ridesharing.
PICKUP	Adatto per far salire un passeggero. Ad esempio, un punto di partenza per il car pooling.
PARKING	Adatto per il parcheggio. Ad esempio, all'interno di un parcheggio.

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 quello 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}. Può essere utilizzato per cercare il luogo.
place_id	string L'identificatore univoco di un luogo.
display_name	LocalizedText Descrizione del luogo leggibile. Ad esempio, "Gate B", "McDonalds"
primary_type	string Il tipo di luogo principale di questo luogo. Consulta https://developers.google.com/maps/documentation/places/web-service/place-types per l'elenco dei valori possibili. Nota: questo campo non viene sempre compilato. In questi casi, preparati a utilizzare il campo types.
types[]	string Tutti i tipi di luoghi associati a questo luogo. Consulta https://developers.google.com/maps/documentation/places/web-service/place-types per l'elenco dei valori possibili.
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 inserire 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, pertanto un oggetto display_polygon può rappresentare più poligoni.
address_components[]	PlaceView.AddressComponent Componenti ripetuti per ogni livello di località.

AddressComponent

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

Campi
long_text	string La descrizione testuale completa o il nome 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 l'Australia potrebbe avere il nome breve "AU".
types[]	string Un array che indica i tipi di componenti dell'indirizzo. Questi valori sono tratti dalla tabella dei tipi di indirizzo e dei tipi di componenti dell'indirizzo utilizzata dall'API Places: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code	string La lingua utilizzata per formattare questo componente, in notazione CLDR.

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 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 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 che sostituisce il prefisso con un 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. Questo influisce sul campo navigation_points restituito nella risposta. Se vuoto, vengono restituiti i punti di navigazione di tutte le modalità di viaggio.
language_code	string Facoltativo. La 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 influisce anche sui risultati del servizio, ma non li limita completamente.
Campo unione primary_query. Query per la destinazione principale. Può essere un luogo, un indirizzo completo o una località LatLng. Alcuni luoghi e indirizzi con informazioni minime non potranno essere trasformati in una destinazione. Le destinazioni vengono create in base alla query primaria 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 della 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

La 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 via nel formato di indirizzo postale.
address_query	string Un indirizzo formattato come singola riga.

LocationQuery

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

Nota: se la query sulla località si trova all'interno di un edificio che contiene sottosedi, è possibile che il luogo principale restituito sia una sottosede. In questi casi, il campo containing_places includerà l'edificio.

Campi
place_filter	SearchDestinationsRequest.LocationQuery.PlaceFilter Facoltativo. Filtri da applicare ai candidati di destinazione.
Campo unione kind. La query sulla posizione. kind può essere solo uno dei seguenti tipi:
location	LatLng Una posizione LatLng precisa.

PlaceFilter

Filtri da applicare ai candidati di destinazione.

Campi
structure_type	PlaceView.StructureType Facoltativo. Se specificato, tutte le destinazioni avranno sicuramente un luogo principale con questo tipo di struttura. Ciò può comportare l'esclusione di alcune destinazioni o l'approssimazione/perfezionamento 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 l'esclusione 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 località 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 i filtri di indirizzabilità. In futuro potrebbero essere aggiunti nuovi valori.

Enum
ADDRESSABILITY_UNSPECIFIED	Se non viene 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 via.
WEAK	Tutte le destinazioni restituite avranno un luogo principale o una destinazione secondaria con un indirizzo o un nome a livello di via.

SearchDestinationsResponse

Messaggio di risposta per DestinationService.SearchDestinations.

Campi
destinations[]	Destination Un elenco di destinazioni. Il servizio restituisce un risultato se è possibile identificare in modo univoco una destinazione principale dalla query principale. In caso contrario, il servizio potrebbe restituire più risultati per la disambiguazione o nessun risultato.

StreetViewThumbnail

Parametri per la rappresentazione di una miniatura di Google Street View. Questi parametri possono essere utilizzati per richiedere un'immagine di Street View dall'API Street View Static. Consulta la pagina https://developers.google.com/maps/documentation/streetview/request-streetview.

Campi
pano	string Un ID panorama specifico.
width_px	int32 Larghezza dell'immagine in miniatura di output in pixel. Nota: quando richiedi le annotazioni insieme alla miniatura, questi valori di altezza e larghezza devono essere utilizzati nella richiesta dell'API Street View per garantire che le coordinate delle annotazioni siano allineate correttamente all'immagine.
height_px	int32 Altezza dell'immagine in miniatura di output in pixel. Nota: quando richiedi le annotazioni insieme alla miniatura, questi valori di altezza e larghezza devono essere utilizzati nella richiesta dell'API Street View per garantire che le coordinate delle annotazioni siano allineate correttamente all'immagine.
heading_degree	float Orientamento orizzontale della videocamera in gradi. Intervallo [0, 360). 0 indica il nord e 90 indica l'est.
pitch_degree	float Orientamento verticale della videocamera in gradi. Intervallo [-90, 90]. 0 è l'orizzonte, +90 è dritto verso l'alto, -90 è dritto verso il basso.
fov_degree	float Campo visivo orizzontale in gradi. Intervallo (0, 180]. Controlla il livello di zoom. Un FOV più piccolo indica uno zoom maggiore.