Indice
LocationSelectionBeta
(interfaccia)Address
(messaggio)AddressComponent
(messaggio)Compound
(messaggio)CompoundTypeEnums
(messaggio)CompoundTypeEnums.CompoundType
(enum)Entrance
(messaggio)FindNearbyPlacesRequest
(messaggio)FindNearbyPlacesResponse
(messaggio)FindPickupPointsForLocationRequest
(messaggio)FindPickupPointsForLocationResponse
(messaggio)FindPickupPointsForPlaceRequest
(messaggio)FindPickupPointsForPlaceResponse
(messaggio)FormattedAddress
(messaggio)Geometry
(messaggio)LocalizationPreferences
(messaggio)PickupPoint
(messaggio)PickupPointOrderEnums
(messaggio)PickupPointOrderEnums.PickupPointOrder
(enum)PickupPointResult
(messaggio)Place
(messaggio)PlacePickupPointResult
(messaggio)PlaceResult
(messaggio)TrafficRestrictionEnums
(messaggio)TrafficRestrictionEnums.TrafficRestriction
(enum)TravelDetail
(messaggio)TravelModeEnums
(messaggio)TravelModeEnums.TravelMode
(enum)WiFiAccessPoint
(messaggio)
LocationSelectionBeta
Il servizio per ricevere luoghi nelle vicinanze e i relativi punti di prelievo e consegna.
FindNearbyPlaces |
---|
Consente di trovare luoghi nelle vicinanze per una determinata località. |
FindPickupPointsForLocation |
---|
Trovare i punti di ritiro per una determinata località. |
FindPickupPointsForPlace |
---|
Trovare i punti di ritiro per un determinato luogo. |
Indirizzo
L'indirizzo di un luogo.
Campi | |
---|---|
formatted_address |
Un indirizzo completo leggibile di questo luogo. |
address_components[] |
Un elenco dei componenti dell'indirizzo. |
AddressComponent
Un componente dell'indirizzo che descrive una parte dell'indirizzo.
Campi | |
---|---|
component_text |
Il nome di questo componente che descrive parte dell'indirizzo. Alcuni esempi sono "California", "Amphitheatre Parkway". |
component_text_short_form |
La forma breve del testo del componente. Alcuni esempi sono "CA" per "California" e "US" per "Stati Uniti". |
types[] |
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 |
Tipo di composto. |
geometry |
La geometria associata al composto. |
entrances[] |
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 |
La posizione dell'ingresso. |
FindNearbyPlacesRequest
Messaggio di richiesta per la ricerca di luoghi nelle vicinanze.
Campi | |
---|---|
localization_preferences |
Obbligatorio. Preferenze utilizzate per la localizzazione del testo nella risposta, ad esempio nome e indirizzo. |
search_location |
Obbligatorio. Località in cui è necessario trovare luoghi. |
max_results |
Obbligatorio. Numero massimo di risultati da restituire. Deve essere maggiore di 0. |
wifi_access_points[] |
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[] |
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 |
Obbligatorio. Preferenze utilizzate per la localizzazione del testo nella risposta, ad esempio nome e indirizzo. |
search_location |
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 |
Obbligatorio. Ordinamento da utilizzare per la restituzione dei risultati. |
destination |
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 |
Obbligatorio. Numero massimo di risultati da restituire. Deve essere maggiore di 0. |
travel_modes[] |
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 |
Se il valore è true, viene calcolato l'orario di arrivo stimato a piedi dalla località di ricerca al punto di prelievo. |
compute_driving_eta |
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[] |
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[] |
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[] |
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 |
Obbligatorio. ID del luogo per il quale vengono richiesti i punti di ritiro. |
localization_preferences |
Obbligatorio. Preferenze utilizzate per la localizzazione del testo nella risposta, ad esempio nome e indirizzo. |
search_location |
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 |
Obbligatorio. Ordinamento da utilizzare per la restituzione dei risultati. |
destination |
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 |
Obbligatorio. Numero massimo di risultati da restituire. Deve essere maggiore di 0. |
travel_modes[] |
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 |
Se il valore è true, viene calcolato l'orario di arrivo stimato a piedi dalla località di ricerca al punto di prelievo. |
compute_driving_eta |
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[] |
Punti di ritiro che corrispondono ai criteri della richiesta. Può essere vuoto se nessun punto di ritiro corrisponde ai criteri della richiesta. |
place_result |
Luogo associato all'ID luogo specificato nella richiesta. |
FormattedAddress
Un indirizzo completo leggibile per l'entità contenente il messaggio.
Campi | |
---|---|
lines[] |
Le righe di testo che descrivono l'indirizzo. Deve essere presente almeno una riga. |
Geometria
Geometria di un luogo.
Campi | |
---|---|
location |
Punto centrale dell'entità contenente il messaggio. |
viewport |
Un'area visibile adatta a mostrare il luogo su una mappa di dimensioni medie. |
display_boundary |
Specifica un poligono utilizzando il formato GeoJSON Polygon |
LocalizationPreferences
Un indirizzo completo leggibile per l'entità contenente il messaggio.
Campi | |
---|---|
language_code |
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 |
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 |
Un ID univoco del punto di ritiro. Deve essere presente. |
display_name |
Nome breve e leggibile del punto di prelievo. Localizzato in base alle preferenze fornite nella richiesta. |
address |
Indirizzo del punto di prelievo. |
description |
Una descrizione più lunga del punto di prelievo, che potrebbe includere come raggiungere la posizione. |
location |
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 |
Il punto di ritiro effettivo che corrisponde alla richiesta. |
distance_meters |
La distanza in linea retta tra il punto di prelievo e la località di ricerca specificata nella richiesta. |
travel_details[] |
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 |
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 |
Nome del luogo localizzato. Localizzato in base alle preferenze fornite nella richiesta. |
language_code |
Codice lingua dei campi di testo associati al luogo. Ad esempio, "nome" e "indirizzo". |
address |
L'indirizzo del luogo. |
geometry |
La geometria del luogo. |
types[] |
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[] |
I composti associati al luogo. |
PlacePickupPointResult
Punti di ritiro con ID luogo associato.
Campi | |
---|---|
pickup_point_result |
Dettagli sul punto di prelievo. Deve essere presente. |
associated_place_id |
ID del luogo associato. |
PlaceResult
Dettagli sul risultato di una ricerca di luoghi.
Campi | |
---|---|
place |
Dettagli su un luogo. |
distance_meters |
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 |
La modalità di viaggio in base alla quale viene calcolato l'orario di arrivo stimato. |
estimated_arrival_time |
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 |
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 |
L'indirizzo MAC del punto di accesso. |
strength_dbm |
L'intensità del segnale del punto di accesso, in dBm. |