Package google.maps.locationselection.v1beta

Indice

LocationSelectionBeta

Il servizio per ricevere luoghi nelle vicinanze e i relativi punti di prelievo e consegna.

FindNearbyPlaces

rpc FindNearbyPlaces(FindNearbyPlacesRequest) returns (FindNearbyPlacesResponse)

Consente di trovare luoghi nelle vicinanze per una determinata località.
FindPickupPointsForLocation

rpc FindPickupPointsForLocation(FindPickupPointsForLocationRequest) returns (FindPickupPointsForLocationResponse)

Trovare i punti di ritiro per una determinata località.
FindPickupPointsForPlace

rpc FindPickupPointsForPlace(FindPickupPointsForPlaceRequest) returns (FindPickupPointsForPlaceResponse)

Trovare i punti di ritiro per un determinato luogo.

Indirizzo

L'indirizzo di un luogo.

Campi
formatted_address

FormattedAddress

Un indirizzo completo leggibile di questo luogo.
address_components[]

AddressComponent

Un elenco dei componenti dell'indirizzo.

AddressComponent

Un componente dell'indirizzo che descrive una parte dell'indirizzo.

Campi
component_text

string

Il nome di questo componente che descrive parte dell'indirizzo. Alcuni esempi sono "California", "Amphitheatre Parkway".
component_text_short_form

string

La forma breve del testo del componente. Alcuni esempi sono "CA" per "California" e "US" per "Stati Uniti".
types[]

string

I tipi di questo componente che descrivono parte dell'indirizzo. Per un elenco dei tipi supportati, vedi https://developers.google.com/places/web-service/supported_types#table2

Complesso

Composto associato a un luogo.

Campi
type

CompoundType

Tipo di composto.
geometry

Geometry

La geometria associata al composto.
entrances[]

Entrance

Elenco di entrate associate al composto.

CompoundTypeEnums

I tipi di composti

CompoundType

Valore del tipo di composto.

Enum
COMPOUND_TYPE_UNSPECIFIED Tipo di composto sconosciuto.
SECTION Sezione composta. https://support.google.com/mapskb/answer/7054299
BUILDING Edificio composto. https://support.google.com/mapskb/answer/7013011
GROUNDS Terreni composti. https://support.google.com/mapskb/answer/7046859

Ingresso

Ingresso di un luogo.

Campi
location

LatLng

La posizione dell'ingresso.

FindNearbyPlacesRequest

Messaggio di richiesta per la ricerca di luoghi nelle vicinanze.

Campi
localization_preferences

LocalizationPreferences

Obbligatorio. Preferenze utilizzate per la localizzazione del testo nella risposta, ad esempio nome e indirizzo.
search_location

LatLng

Obbligatorio. Località in cui è necessario trovare luoghi.
max_results

int32

Obbligatorio. Numero massimo di risultati da restituire. Deve essere maggiore di 0.
wifi_access_points[]

WiFiAccessPoint

Punti di accesso Wi-Fi nelle vicinanze della posizione della richiesta. Utilizzato per fornire risultati di ricerca di qualità superiore.

FindNearbyPlacesResponse

Consente di trovare luoghi nelle vicinanze per un determinato messaggio di risposta alla posizione.

Campi
place_results[]

PlaceResult

Elenco ordinato di luoghi trovati. Potrebbe essere vuoto se non sono stati trovati luoghi intorno alla località della richiesta. L'ordinamento è basato su una combinazione di probabilità e distanza.

FindPickupPointsForLocationRequest

Messaggio di richiesta Find PickupPointsForLocation.

Campi
localization_preferences

LocalizationPreferences

Obbligatorio. Preferenze utilizzate per la localizzazione del testo nella risposta, ad esempio nome e indirizzo.
search_location

LatLng

Obbligatorio. Posizione da utilizzare per la ricerca dei punti di prelievo e il calcolo delle distanze e degli orari di arrivo stimati in base ai punti di prelievo.
order_by

PickupPointOrder

Obbligatorio. Ordinamento da utilizzare per la restituzione dei risultati.
destination

LatLng

La località di destinazione prevista dal cliente. Imposta quando richiedi punti di prelievo ordinati in base all'orario di arrivo stimato della destinazione.
max_results

int32

Obbligatorio. Numero massimo di risultati da restituire. Deve essere maggiore di 0.
travel_modes[]

TravelMode

Obbligatorio. Vengono restituiti solo i punti di ritiro che consentono almeno una delle modalità di viaggio specificate. Modalità di viaggio supportate: DRIVING e TWO_WHEELER. È necessario specificare almeno una modalità.
compute_walking_eta

bool

Se il valore è true, viene calcolato l'orario di arrivo stimato a piedi dalla località di ricerca al punto di prelievo.
compute_driving_eta

bool

Se vengono specificati true e la destinazione, viene calcolato l'orario di arrivo stimato in auto dal punto di prelievo alla destinazione.
wifi_access_points[]

WiFiAccessPoint

Punti di accesso Wi-Fi nelle vicinanze della posizione di ricerca. Utilizzato per fornire risultati di ricerca di qualità superiore.

FindPickupPointsForLocationResponse

Trova i punti di prelievo per un messaggio di risposta alla posizione.

Campi
place_pickup_point_results[]

PlacePickupPointResult

Punti di ritiro nelle vicinanze con ID luogo associato. I risultati in questo elenco vengono ordinati in base ai criteri specificati nella richiesta. Il numero di risultati in "place_pickup_point_results" potrebbe superare il numero di risultati in "place_results".
place_results[]

PlaceResult

Dettagli sui luoghi associati ai punti di prelievo nelle vicinanze. I risultati in questo elenco non sono ordinati.

FindPickupPointsForPlaceRequest

Messaggio di richiesta Find PickupPointsForPlace.

Campi
place_id

string

Obbligatorio. ID del luogo per il quale vengono richiesti i punti di ritiro.
localization_preferences

LocalizationPreferences

Obbligatorio. Preferenze utilizzate per la localizzazione del testo nella risposta, ad esempio nome e indirizzo.
search_location

LatLng

Posizione da utilizzare per la ricerca dei punti di prelievo e il calcolo delle distanze e degli orari di arrivo stimati in base ai punti di prelievo. Se non viene impostato, viene utilizzata la posizione del luogo associato all'ID luogo specificato.
order_by

PickupPointOrder

Obbligatorio. Ordinamento da utilizzare per la restituzione dei risultati.
destination

LatLng

La località di destinazione prevista dal cliente. Da impostare se richiedi l'ordine dei punti di ritiro in base all'orario di arrivo stimato della destinazione.
max_results

int32

Obbligatorio. Numero massimo di risultati da restituire. Deve essere maggiore di 0.
travel_modes[]

TravelMode

Obbligatorio. Vengono restituiti solo i punti di ritiro che consentono almeno una delle modalità di viaggio specificate. Modalità di viaggio supportate: DRIVING e TWO_WHEELER. È necessario specificare almeno una modalità.
compute_walking_eta

bool

Se il valore è true, viene calcolato l'orario di arrivo stimato a piedi dalla località di ricerca al punto di prelievo.
compute_driving_eta

bool

Se vengono specificati true e la destinazione, viene calcolato l'orario di arrivo stimato in auto dal punto di prelievo alla destinazione.

FindPickupPointsForPlaceResponse

Trova i punti di ritiro per il messaggio di risposta al luogo.

Campi
pickup_point_results[]

PickupPointResult

Punti di ritiro che corrispondono ai criteri della richiesta. Può essere vuoto se nessun punto di ritiro corrisponde ai criteri della richiesta.
place_result

PlaceResult

Luogo associato all'ID luogo specificato nella richiesta.

FormattedAddress

Un indirizzo completo leggibile per l'entità contenente il messaggio.

Campi
lines[]

string

Le righe di testo che descrivono l'indirizzo. Deve essere presente almeno una riga.

Geometria

Geometria di un luogo.

Campi
location

LatLng

Punto centrale dell'entità contenente il messaggio.
viewport

Viewport

Un'area visibile adatta a mostrare il luogo su una mappa di dimensioni medie.
display_boundary

Struct

Specifica un poligono utilizzando il formato GeoJSON Polygon

LocalizationPreferences

Un indirizzo completo leggibile per l'entità contenente il messaggio.

Campi
language_code

string

Obbligatorio. Il tag della lingua BCP-47 utilizzato per la localizzazione dei testi. Esempi di tag lingua sono "en-US", "hi-IN", "fr-CA" e così via.
region_code

string

Obbligatorio. Il codice Unicode paese/regione (CLDR) della località da cui proviene la richiesta, ad esempio "US" e "419".

Per ulteriori informazioni, visita la pagina http://www.unicode.org/reports/tr35/#unicode_region_subtag.

PickupPoint

Dettagli su un punto di prelievo o di arrivo.

Campi
id

string

Un ID univoco del punto di ritiro. Deve essere presente.
display_name

string

Nome breve e leggibile del punto di prelievo. Localizzato in base alle preferenze fornite nella richiesta.
address

Address

Indirizzo del punto di prelievo.
description

string

Una descrizione più lunga del punto di prelievo, che potrebbe includere come raggiungere la posizione.
location

LatLng

Luogo del punto di prelievo, ovvero il punto in cui un passeggero o un ricevitore incontrano il conducente. Deve essere presente.

PickupPointOrderEnums

Insieme di valori che specificano l'ordine dei punti di prelievo corrispondenti.

PickupPointOrder

Valore dell'ordine del punto di ritiro.

Enum
PICKUP_POINT_ORDER_UNSPECIFIED Ordine del punto di ritiro non specificato. Il valore predefinito è DISTANZA_FROM_ORIGIN.
DISTANCE_FROM_SEARCH_LOCATION Ordine crescente della distanza in linea retta dalla località di ricerca al punto di prelievo restituito.
WALKING_ETA_FROM_SEARCH_LOCATION Ordine crescente in base al tempo di percorrenza a piedi del consumatore dalla località di ricerca al punto di ritiro.
DRIVING_ETA_FROM_PICKUP_POINT_TO_DESTINATION Ordine crescente specificando l'orario di arrivo stimato dal punto di ritiro alla destinazione del consumatore. Questa modalità può essere utilizzata solo quando è impostata una destinazione e compute_driving_eta è true. Quando nella richiesta vengono specificati più "travel_modes", l'ordinamento si basa sulla prima modalità di viaggio nella richiesta.

PickupPointResult

Dettagli sul risultato di ricerca relativo a un punto di ritiro.

Campi
pickup_point

PickupPoint

Il punto di ritiro effettivo che corrisponde alla richiesta.
distance_meters

float

La distanza in linea retta tra il punto di prelievo e la località di ricerca specificata nella richiesta.
travel_details[]

TravelDetail

I dettagli associati al viaggio da e verso questo punto di prelievo per ogni modalità di viaggio richiesta.

Posizione

Dettagli su un luogo.

Campi
place_id

string

ID luogo del luogo. Un ID luogo è un testo che identifica in modo univoco un luogo. https://developers.google.com/places/web-service/place-id
display_name

string

Nome del luogo localizzato. Localizzato in base alle preferenze fornite nella richiesta.
language_code

string

Codice lingua dei campi di testo associati al luogo. Ad esempio, "nome" e "indirizzo".
address

Address

L'indirizzo del luogo.
geometry

Geometry

La geometria del luogo.
types[]

string

Un insieme di tag di tipo per questo risultato. Ad esempio, "political" e "locality". https://developers.google.com/places/web-service/supported_types
associated_compounds[]

Compound

I composti associati al luogo.

PlacePickupPointResult

Punti di ritiro con ID luogo associato.

Campi
pickup_point_result

PickupPointResult

Dettagli sul punto di prelievo. Deve essere presente.
associated_place_id

string

ID del luogo associato.

PlaceResult

Dettagli sul risultato di una ricerca di luoghi.

Campi
place

Place

Dettagli su un luogo.
distance_meters

float

La distanza in linea retta dalla posizione di ricerca al centro o alla geometria del luogo.

TrafficRestrictionEnums

Tipi di limitazioni al traffico per una località.

TrafficRestriction

Valore della limitazione del traffico.

Enum
TRAFFIC_RESTRICTION_UNSPECIFIED La limitazione non è specificata.
NO_RESTRICTION Non vengono applicate limitazioni al traffico.
OTHER_RESTRICTION Potrebbero essere applicate alcune limitazioni al traffico, ad esempio la strada è privata o l'accesso alla posizione associata è a pagamento.

TravelDetail

I dettagli associati al viaggio.

Campi
travel_mode

TravelMode

La modalità di viaggio in base alla quale viene calcolato l'orario di arrivo stimato.
estimated_arrival_time

Timestamp

L'ora di arrivo prevista. L'orario di arrivo stimato a piedi viene calcolato dalla posizione della ricerca alla posizione del punto di prelievo quando nella richiesta è impostato compute_walking_eta. L'orario di arrivo stimato in auto viene calcolato dalla posizione del punto di partenza alla destinazione per ogni modalità di viaggio richiesta non a piedi quando compute_driving_eta e la destinazione sono impostati nella richiesta. L'orario di arrivo stimato in auto viene calcolato in base al traffico e NON è soggetto a limitazioni di traffico.
traffic_restriction

TrafficRestriction

La limitazione che si applica alla modalità di viaggio.

TravelModeEnums

L'elenco delle modalità di viaggio disponibili per raggiungere una località.

TravelMode

Valore della modalità di viaggio.

Enum
TRAVEL_MODE_UNSPECIFIED Modalità di viaggio non specificata.
WALKING A piedi, utilizzata per i pedoni.
DRIVING Auto, utilizzato per le autovetture.
TWO_WHEELER Motocicli a due ruote (ad esempio motocicli o ciclomotori).

WiFiAccessPoint

Informazioni sul punto di accesso Wi-Fi.

Campi
mac_address

int64

L'indirizzo MAC del punto di accesso.
strength_dbm

sint32

L'intensità del segnale del punto di accesso, in dBm.