Package google.maps.locationselection.v1beta

Indice

LocationSelectionBeta

Il servizio per trovare i luoghi nelle vicinanze e i punti di ritiro e consegna associati.

FindNearbyPlaces

rpc FindNearbyPlaces(FindNearbyPlacesRequest) returns (FindNearbyPlacesResponse)

Trova 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

Indirizzo di un luogo.

Campi
formatted_address

FormattedAddress

Un indirizzo completo e leggibile per questo luogo.
address_components[]

AddressComponent

Un elenco di 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 abbreviata del testo del componente. Alcuni esempi sono "CA" per "California" e "US" per "Stati Uniti".
types[]

string

Tipi di questo componente che descrivono parte dell'indirizzo. Per un elenco dei tipi supportati, visita la pagina 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 degli ingressi associati al complesso.

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 di un complesso. https://support.google.com/mapskb/answer/7013011
GROUNDS Terreni di complessi. https://support.google.com/mapskb/answer/7046859

Ingresso

Ingresso di un luogo.

Campi
location

LatLng

La posizione dell'ingresso.

FindNearbyPlacesRequest

Messaggio di richiesta per trovare luoghi nelle vicinanze.

Campi
localization_preferences

LocalizationPreferences

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

LatLng

Obbligatorio. Posizione in cui è necessario trovare luoghi.
max_results

int32

Obbligatorio. Il 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

Trova i luoghi nelle vicinanze per un determinato messaggio di risposta alla località.

Campi
place_results[]

PlaceResult

Elenco ordinato dei luoghi trovati. Può essere vuoto se non sono stati trovati luoghi intorno alla località della richiesta. L'ordinamento si basa su una combinazione di probabilità e distanza.

FindPickupPointsForLocationRequest

Messaggio di richiesta FindPickupPointsForLocation.

Campi
localization_preferences

LocalizationPreferences

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

LatLng

Obbligatorio. Posizione da utilizzare per cercare i punti di ritiro e calcolare le distanze e gli orari di arrivo stimati fino ai punti di ritiro.
order_by

PickupPointOrder

Obbligatorio. L'ordinamento da utilizzare per restituire i risultati.
destination

LatLng

Posizione della destinazione prevista del cliente. Imposta quando richiedi punti di ritiro 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 è vero, viene calcolato l'orario di arrivo stimato a piedi dal punto di ricerca al punto di partenza.
compute_driving_eta

bool

Se è specificato true e la destinazione è specificata, viene calcolato l'orario di arrivo stimato dal punto di prelievo alla destinazione.
wifi_access_points[]

WiFiAccessPoint

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

FindPickupPointsForLocationResponse

Trovare i punti di ritiro per il 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" può superare il numero di risultati in "place_results".
place_results[]

PlaceResult

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

FindPickupPointsForPlaceRequest

Messaggio di richiesta FindPickupPointsForPlace.

Campi
place_id

string

Obbligatorio. L'ID luogo per cui sono richiesti i punti di ritiro.
localization_preferences

LocalizationPreferences

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

LatLng

Località da utilizzare per cercare i punti di ritiro e calcolare le distanze e l'orario di arrivo stimato rispetto ai punti di ritiro. Se non è impostato, viene utilizzata la posizione del luogo associata all'ID luogo specificato.
order_by

PickupPointOrder

Obbligatorio. L'ordinamento da utilizzare per restituire i risultati.
destination

LatLng

Posizione della destinazione prevista del cliente. Imposta se richiedere l'ordinamento dei punti di ritiro in base all'orario di arrivo stimato (ETA) della destinazione.
max_results

int32

Obbligatorio. Il 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 è vero, viene calcolato l'orario di arrivo stimato a piedi dal punto di ricerca al punto di partenza.
compute_driving_eta

bool

Se true e la destinazione è specificata, viene calcolato l'orario di arrivo stimato in auto dal punto di ritiro alla destinazione.

FindPickupPointsForPlaceResponse

Trovare i punti di ritiro per il messaggio di risposta del luogo.

Campi
pickup_point_results[]

PickupPointResult

Punti di prelievo che corrispondono ai criteri della richiesta. Può essere vuoto se non sono presenti punti di ritiro corrispondenti ai criteri della richiesta.
place_result

PlaceResult

Luogo associato all'ID luogo specificato nella richiesta.

FormattedAddress

Un indirizzo completo e leggibile per l'entità contenente questo 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 questo messaggio.
viewport

Viewport

Un'area visibile adatta per la visualizzazione del luogo su una mappa di dimensioni medie.
display_boundary

Struct

Specifica un poligono utilizzando il formato GeoJSON Polygon

LocalizationPreferences

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

Campi
language_code

string

Obbligatorio. Il tag lingua BCP-47 utilizzato per la localizzazione dei testi. Esempi di tag per la 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 ritiro o consegna.

Campi
id

string

Un ID univoco per il punto di ritiro. Deve essere presente.
display_name

string

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

Address

Indirizzo del punto di ritiro.
description

string

Una descrizione più lunga del punto di ritiro, che può includere le indicazioni per raggiungere la stazione di ricarica.
location

LatLng

Posizione del punto di prelievo; luogo in cui un passeggero o un ricevitore incontrano il conducente. Deve essere presente.

PickupPointOrderEnums

Insieme di valori che specificano l'ordinamento dei punti di ritiro corrispondenti.

PickupPointOrder

Valore dell'ordine del punto di ritiro.

Enum
PICKUP_POINT_ORDER_UNSPECIFIED Ordine del punto di ritiro non specificato. Il valore predefinito è DISTANCE_FROM_ORIGIN.
DISTANCE_FROM_SEARCH_LOCATION Ordine crescente della distanza in linea retta dalla posizione di ricerca al punto di ritiro restituito.
WALKING_ETA_FROM_SEARCH_LOCATION In 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 In ordine crescente in base all'orario di arrivo stimato in auto dal punto di ritiro alla destinazione del consumatore. Questa modalità può essere utilizzata solo se è impostata una destinazione e il valore compute_driving_eta è true. Quando nella richiesta vengono specificati più travel_mode, l'ordinamento si basa sul primo travel_mode nella richiesta.

PickupPointResult

Dettagli su un 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 questo punto di prelievo e la località di ricerca specificata nella richiesta.
travel_details[]

TravelDetail

I dettagli associati ai viaggi da e verso questo punto di ritiro per ogni modalità di viaggio richiesta.

Luogo

Dettagli su un luogo.

Campi
place_id

string

ID posizione 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

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 ritiro. Deve essere presente.
associated_place_id

string

ID del luogo associato.

PlaceResult

Dettagli su un risultato di ricerca di luoghi.

Campi
place

Place

Dettagli su un luogo.
distance_meters

float

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

TrafficRestrictionEnums

Tipi di limitazioni del traffico per una località.

TrafficRestriction

Valore della limitazione del traffico.

Enum
TRAFFIC_RESTRICTION_UNSPECIFIED La limitazione non è 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 è previsto un costo per accedere alla località associata.

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'orario di arrivo previsto. L'orario di arrivo stimato a piedi viene calcolato dalla località di ricerca alla località del punto di ritiro quando compute_walking_eta è impostato nella richiesta. L'orario di arrivo stimato in auto viene calcolato dalla posizione del punto di ritiro alla destinazione per ogni modalità di viaggio non pedonale richiesta quando nella richiesta sono impostati compute_driving_eta e destination. L'orario di arrivo stimato in auto viene calcolato in base al traffico e NON è soggetto a restrizioni dovute al traffico intenso.
traffic_restriction

TrafficRestriction

La restrizione 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 La modalità di spostamento non è specificata.
WALKING A piedi, utilizzato per i pedoni.
DRIVING Guida, utilizzato per autovetture.
TWO_WHEELER Moto a due ruote (ad es. motocicli o ciclomotori).

WiFiAccessPoint

Informazioni sui punti 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.