Package google.maps.places.v1

Indice

Luoghi

Definizione del servizio per l'API Places. Nota: ogni richiesta (tranne le richieste di completamento automatico) richiede una maschera di campo impostata al di fuori del proto della richiesta (all/* non è presupposto). La maschera di campo può essere impostata tramite l'intestazione HTTP X-Goog-FieldMask. Vedi: https://developers.google.com/maps/documentation/places/web-service/choose-fields

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

Restituisce le previsioni per l'input specificato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

Recupera un file multimediale con una stringa di riferimento della foto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc GetPlace(GetPlaceRequest) returns (Place)

Visualizza i dettagli di un luogo in base al nome della risorsa, che è una stringa nel formato places/{place_id}.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

Cerca luoghi nelle vicinanze di una località.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

Ricerca di luoghi basata su query di testo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

AddressDescriptor

Una descrizione relazionale di una località. Include un insieme classificato di punti di riferimento nelle vicinanze e aree contenenti precise e la loro relazione con la località target.

Campi
landmarks[]

Landmark

Un elenco classificato di punti di riferimento nelle vicinanze. I punti di riferimento più riconoscibili e vicini sono classificati per primi.
areas[]

Area

Un elenco classificato di aree contenenti o adiacenti. Le aree più riconoscibili e precise vengono classificate per prime.

Area

Informazioni sull'area e sulla sua relazione con la località target.

Le aree includono frazioni precise, quartieri e complessi di grandi dimensioni utili per descrivere una località.

Campi
name

string

Il nome della risorsa dell'area.
place_id

string

L'ID posizione dell'area.
display_name

LocalizedText

Il nome visualizzato dell'area.
containment

Containment

Definisce la relazione spaziale tra la località di destinazione e l'area.

Contenimento

Definisce la relazione spaziale tra la località di destinazione e l'area.

Enum
CONTAINMENT_UNSPECIFIED Il contenimento non è specificato.
WITHIN La località di destinazione si trova all'interno della regione dell'area, vicino al centro.
OUTSKIRTS La località target si trova all'interno della regione dell'area, vicino al bordo.
NEAR La località di destinazione si trova al di fuori della regione dell'area, ma nelle vicinanze.

Punto di riferimento

Informazioni di base sul punto di riferimento e sulla sua relazione con la località di destinazione.

I punti di riferimento sono luoghi ben visibili che possono essere utilizzati per descrivere una località.

Campi
name

string

Il nome della risorsa del punto di riferimento.
place_id

string

L'ID posizione del punto di riferimento.
display_name

LocalizedText

Il nome visualizzato del punto di riferimento.
types[]

string

Un insieme di tag di tipo per questo punto di riferimento. Per un elenco completo dei valori possibili, visita la pagina https://developers.google.com/maps/documentation/places/web-service/place-types.
spatial_relationship

SpatialRelationship

Definisce la relazione spaziale tra la località di destinazione e il punto di riferimento.
straight_line_distance_meters

float

La distanza in linea retta, in metri, tra il punto centrale del target e il punto centrale del punto di riferimento. In alcuni casi, questo valore può essere più lungo di travel_distance_meters.
travel_distance_meters

float

La distanza percorsa, in metri, lungo la rete stradale dal target al punto di riferimento, se noto. Questo valore non tiene conto della modalità di trasporto, ad esempio a piedi, in auto o in bicicletta.

SpatialRelationship

Definisce la relazione spaziale tra la località di destinazione e il punto di riferimento.

Enum
NEAR Questa è la relazione predefinita quando non si applica nulla di più specifico di seguito.
WITHIN Il punto di riferimento ha una geometria spaziale e il target si trova all'interno dei suoi limiti.
BESIDE Il target è direttamente adiacente al punto di riferimento.
ACROSS_THE_ROAD Il target si trova direttamente di fronte al punto di riferimento sull'altro lato della strada.
DOWN_THE_ROAD Sullo stesso percorso del punto di riferimento, ma non accanto o di fronte.
AROUND_THE_CORNER Non sullo stesso percorso del punto di riferimento, ma a una sola svolta di distanza.
BEHIND Vicino alla struttura del punto di riferimento, ma più lontano dagli ingressi sulla strada.

AuthorAttribution

Informazioni sull'autore dei dati relativi ai contenuti generati dagli utenti. Utilizzata in Photo e Review.

Campi
display_name

string

Nome dell'autore del Photo o del Review.
uri

string

URI dell'autore del Photo o del Review.
photo_uri

string

URI della foto del profilo dell'autore del Photo o del Review.

AutocompletePlacesRequest

Richiedi il proto per AutocompletePlaces.

Campi
input

string

Obbligatorio. La stringa di testo in cui cercare.
location_bias

LocationBias

Facoltativo. Spostare i risultati in base a una località specificata.

Deve essere impostato al massimo un valore per location_bias o location_restriction. Se non viene impostato nessuno dei due, i risultati saranno influenzati dall'indirizzo IP, il che significa che l'indirizzo IP verrà mappato a una posizione imprecisa e utilizzato come indicatore di bias.
location_restriction

LocationRestriction

Facoltativo. Limita i risultati a una località specificata.

Deve essere impostato al massimo un valore per location_bias o location_restriction. Se non viene impostato nessuno dei due, i risultati saranno influenzati dall'indirizzo IP, il che significa che l'indirizzo IP verrà mappato a una posizione imprecisa e utilizzato come indicatore di bias.
included_primary_types[]

string

Facoltativo. Tipo di luogo principale incluso (ad es. "restaurant" o "gas_station") nei tipi di luogo (https://developers.google.com/maps/documentation/places/web-service/place-types) oppure solo (regions) o solo (cities). Un luogo viene restituito solo se il relativo tipo principale è incluso in questo elenco. È possibile specificare fino a 5 valori. Se non vengono specificati tipi, vengono restituiti tutti i tipi di luogo.
included_region_codes[]

string

Facoltativo. Includi solo i risultati nelle regioni specificate, specificate come massimo 15 codici regione CLDR di due caratteri. Un insieme vuoto non limita i risultati. Se sono impostati sia location_restriction sia included_region_codes, i risultati si troveranno nell'area di intersezione.
language_code

string

Facoltativo. La lingua in cui restituire i risultati. Il valore predefinito è en-US. I risultati possono essere in lingue miste se la lingua utilizzata in input è diversa da language_code o se il luogo restituito non ha una traduzione dalla lingua locale a language_code.
region_code

string

Facoltativo. Il codice regione, specificato come codice regione CLDR a due caratteri. Ciò influisce sulla formattazione degli indirizzi, sul ranking dei risultati e può influire sui risultati restituiti. Ciò non limita i risultati alla regione specificata. Per limitare i risultati a una regione, utilizza region_code_restriction.
origin

LatLng

Facoltativo. Il punto di partenza da cui calcolare la distanza geodetica alla destinazione (restituito come distance_meters). Se questo valore viene omesso, la distanza geodetica non verrà restituita.
input_offset

int32

Facoltativo. Un offset di caratteri Unicode basato su zero di input che indica la posizione del cursore in input. La posizione del cursore può influire sulle previsioni restituite.

Se è vuoto, il valore predefinito è input.
include_query_predictions

bool

Facoltativo. Se true, la risposta includerà sia le previsioni di luoghi che quelle di query. In caso contrario, la risposta restituirà solo le previsioni dei luoghi.
session_token

string

Facoltativo. Una stringa che identifica una sessione Autocomplete a fini di fatturazione. Deve essere una stringa base64 sicura per URL e nomi file con una lunghezza massima di 36 caratteri ASCII. In caso contrario, viene restituito un errore INVALID_ARGUMENT.

La sessione inizia quando l'utente inizia a digitare una query e termina quando seleziona un luogo e viene effettuata una chiamata a Dettagli dei luoghi o Convalida indirizzo. Ogni sessione può avere più query, seguite da una richiesta di dettagli sui luoghi o di convalida dell'indirizzo. Le credenziali utilizzate per ogni richiesta all'interno di una sessione devono appartenere allo stesso progetto della console Google Cloud. Al termine di una sessione, il token non è più valido; l'app deve generare un nuovo token per ogni sessione. Se il parametro session_token viene omesso o se riutilizzi un token sessione, la sessione viene addebitata come se non fosse stato fornito alcun token sessione (ogni richiesta viene fatturata separatamente).

Ti consigliamo di seguire le seguenti linee guida:

  • Utilizza i token di sessione per tutte le chiamate di completamento automatico dei luoghi.
  • Genera un nuovo token per ogni sessione. Si consiglia di utilizzare un UUID versione 4.
  • Assicurati che le credenziali utilizzate per tutte le richieste di completamento automatico dei luoghi, dei dettagli dei luoghi e di convalida dell'indirizzo all'interno di una sessione appartengano allo stesso progetto Cloud Console.
  • Assicurati di passare un token di sessione univoco per ogni nuova sessione. Se utilizzi lo stesso token per più sessioni, ogni richiesta verrà fatturata singolarmente.
include_pure_service_area_businesses

bool

Facoltativo. Includi le attività al domicilio del cliente se il campo è impostato su true. Un'attività al domicilio del cliente è un'attività che effettua consegne a domicilio o raggiunge direttamente i clienti, ma non presta servizio ai clienti presso l'indirizzo aziendale. Ad esempio, attività come servizi di pulizia o idraulici. Queste attività non hanno un indirizzo fisico o una sede su Google Maps. Per queste attività, Places non restituirà campi tra cui location, plus_code e altri campi relativi alla posizione.

LocationBias

La regione in cui cercare. I risultati potrebbero essere parziali per la regione specificata.

Campi

Campo unione type.

type può essere solo uno dei seguenti:
rectangle

Viewport

Un viewport definito da un angolo nord-est e da un angolo sud-ovest.
circle

Circle

Un cerchio definito da un punto centrale e un raggio.

LocationRestriction

La regione in cui cercare. I risultati saranno limitati alla regione specificata.

Campi

Campo unione type.

type può essere solo uno dei seguenti:
rectangle

Viewport

Un viewport definito da un angolo nord-est e da un angolo sud-ovest.
circle

Circle

Un cerchio definito da un punto centrale e un raggio.

AutocompletePlacesResponse

Proto di risposta per AutocompletePlaces.

Campi
suggestions[]

Suggestion

Contiene un elenco di suggerimenti, ordinati in ordine decrescente di pertinenza.

Suggerimento

Un risultato del suggerimento di completamento automatico.

Campi

Campo unione kind.

kind può essere solo uno dei seguenti:
place_prediction

PlacePrediction

Una previsione per un luogo.
query_prediction

QueryPrediction

Una previsione per una query.

FormattableText

Testo che rappresenta una previsione di una località o di una query. Il testo può essere utilizzato così com'è o formattato.

Campi
text

string

Testo che può essere utilizzato così com'è o formattato con matches.
matches[]

StringRange

Un elenco di intervalli di stringhe che identificano dove la richiesta di input corrisponde a text. Gli intervalli possono essere utilizzati per formattare parti specifiche di text. Le sottostringhe potrebbero non corrispondere esattamente a input se la corrispondenza è stata determinata da criteri diversi dalla corrispondenza di stringhe (ad es. correzioni ortografica o traslitterazioni).

Questi valori sono gli offset dei caratteri Unicode di text. Gli intervalli sono garantiti per essere ordinati in valori di offset crescenti.

PlacePrediction

Risultati della previsione per una previsione di completamento automatico dei luoghi.

Campi
place

string

Il nome della risorsa del luogo suggerito. Questo nome può essere utilizzato in altre API che accettano nomi di luoghi.
place_id

string

L'identificatore univoco del luogo suggerito. Questo identificatore può essere utilizzato in altre API che accettano ID luogo.
text

FormattableText

Contiene il nome leggibile del risultato restituito. Per i risultati relativi a un'attività, in genere si tratta del nome e dell'indirizzo dell'attività.

text è consigliato per gli sviluppatori che vogliono mostrare un singolo elemento dell'interfaccia utente. Gli sviluppatori che vogliono mostrare due elementi dell'interfaccia utente distinti, ma correlati, potrebbero preferire utilizzare structured_format. Si tratta di due modi diversi per rappresentare una previsione di luogo. Gli utenti non devono tentare di analizzare structured_format in text o viceversa.

Questo testo potrebbe essere diverso da display_name restituito da GetPlace.

Può essere in lingue miste se le richieste input e language_code sono in lingue diverse o se il luogo non ha una traduzione dalla lingua locale a language_code.
structured_format

StructuredFormat

Un'analisi della previsione del luogo in un testo principale contenente il nome del luogo e un testo secondario contenente ulteriori elementi di disambiguazione (ad esempio una città o una regione).

structured_format è consigliato per gli sviluppatori che vogliono mostrare due elementi dell'interfaccia utente distinti, ma correlati. Gli sviluppatori che vogliono mostrare un singolo elemento dell'interfaccia utente potrebbero preferire utilizzare text. Si tratta di due modi diversi per rappresentare una previsione di luogo. Gli utenti non devono tentare di analizzare structured_format in text o viceversa.
types[]

string

Elenco dei tipi che si applicano a questo luogo dalla Tabella A o dalla Tabella B in https://developers.google.com/maps/documentation/places/web-service/place-types.

Un tipo è una classificazione di un luogo. I luoghi con tipi condivisi avranno caratteristiche simili.
distance_meters

int32

La lunghezza della geodetica in metri da origin se origin è specificato. Determinate previsioni, come i percorsi, potrebbero non compilare questo campo.

QueryPrediction

Risultati di previsione per una previsione di completamento automatico della query.

Campi
text

FormattableText

Il testo previsto. Questo testo non rappresenta un luogo, ma una query di testo che potrebbe essere utilizzata in un endpoint di ricerca (ad esempio Ricerca di testo).

text è consigliato per gli sviluppatori che vogliono mostrare un singolo elemento dell'interfaccia utente. Gli sviluppatori che vogliono mostrare due elementi dell'interfaccia utente distinti, ma correlati, potrebbero preferire utilizzare structured_format. Si tratta di due modi diversi per rappresentare una previsione della query. Gli utenti non devono tentare di analizzare structured_format in text o viceversa.

Può essere in lingue miste se la richiesta input e language_code sono in lingue diverse o se parte della query non ha una traduzione dalla lingua locale a language_code.
structured_format

StructuredFormat

Un'analisi dettagliata della previsione della query in un testo principale contenente la query e un testo secondario contenente ulteriori elementi di disambiguazione (ad esempio una città o una regione).

structured_format è consigliato per gli sviluppatori che vogliono mostrare due elementi dell'interfaccia utente distinti, ma correlati. Gli sviluppatori che vogliono mostrare un singolo elemento dell'interfaccia utente potrebbero preferire utilizzare text. Si tratta di due modi diversi per rappresentare una previsione della query. Gli utenti non devono tentare di analizzare structured_format in text o viceversa.

StringRange

Identifica una sottostringa all'interno di un determinato testo.

Campi
start_offset

int32

Offset a partire da zero del primo carattere Unicode della stringa (incluso).
end_offset

int32

Offset basato su zero dell'ultimo carattere Unicode (esclusivo).

StructuredFormat

Contiene una suddivisione della previsione di un luogo o di una query in testo principale e testo secondario.

Per le previsioni dei luoghi, il testo principale contiene il nome specifico del luogo. Per le previsioni delle query, il testo principale contiene la query.

Il testo secondario contiene ulteriori elementi di disambiguazione (ad esempio una città o una regione) per identificare ulteriormente il luogo o perfezionare la query.

Campi
main_text

FormattableText

Rappresenta il nome del luogo o della query.
secondary_text

FormattableText

Rappresenta elementi aggiuntivi per distinguere (ad esempio una città o una regione) per identificare ulteriormente il luogo o perfezionare la query.

Cerchio

Cerchio con un valore LatLng come centro e raggio.

Campi
center

LatLng

Obbligatorio. Latitudine e longitudine al centro.

L'intervallo di latitudine deve essere compreso tra [-90,0, 90,0]. L'intervallo della longitudine deve essere compreso tra [-180,0, 180,0].
radius

double

Obbligatorio. Raggio misurato in metri. Il raggio deve essere compreso tra 0,0 e 50000,0.

ContentBlock

Un blocco di contenuti che può essere pubblicato singolarmente.

Campi
topic

string

L'argomento dei contenuti, ad esempio "panoramica" o "ristorante".
content

LocalizedText

Contenuti correlati all'argomento.
references

References

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riferimenti correlati a questo blocco di contenuti.

ContextualContent

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Contenuti contestuali alla query sul luogo.

Campi
reviews[]

Review

Elenco di recensioni su questo luogo, contestualizzate alla query sul luogo.
photos[]

Photo

Informazioni (inclusi i riferimenti) sulle foto di questo luogo, contestuali alla query sul luogo.
justifications[]

Justification

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Motivazioni per il luogo.

Giustificazione

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Motivazioni per il luogo. Le giustificazioni rispondono alla domanda sul motivo per cui un luogo potrebbe interessare un utente finale.

Campi

Campo unione justification.

justification può essere solo uno dei seguenti:
review_justification

ReviewJustification

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

BusinessAvailabilityAttributesJustification

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Giustificazioni di BusinessAvailabilityAttributes. Vengono mostrati alcuni attributi di un'attività che potrebbero interessare un utente finale.

Campi
takeout

bool

Se un luogo offre cibo da asporto.
delivery

bool

Se un luogo offre il servizio di consegna a domicilio.
dine_in

bool

Se un luogo offre la consumazione sul posto.

ReviewJustification

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Giustificazioni delle recensioni degli utenti. Viene evidenziata una sezione della recensione dell'utente che potrebbe interessare un utente finale. Ad esempio, se la query di ricerca è "pizza alla brace", la motivazione della recensione mette in evidenza il testo pertinente alla query di ricerca.

Campi
highlighted_text

HighlightedText
review

Review

La recensione da cui viene generato il testo evidenziato.

HighlightedText

Il testo evidenziato dalla giustificazione. Si tratta di un sottoinsieme della recensione stessa. La parola esatta da evidenziare è contrassegnata da HighlightedTextRange. Nel testo potrebbero essere evidenziate diverse parole.

Campi
text

string
highlighted_text_ranges[]

HighlightedTextRange

L'elenco degli intervalli del testo evidenziato.

HighlightedTextRange

L'intervallo di testo evidenziato.

Campi
start_index

int32
end_index

int32

EVChargeOptions

Informazioni sulla stazione di ricarica EV ospitata nel luogo. La terminologia segue le indicazioni riportate all'indirizzo https://afdc.energy.gov/fuels/electricity_infrastructure.html. Una porta potrebbe ricaricare un'auto alla volta. Una porta ha uno o più connettori. Una stazione ha una o più porte.

Campi
connector_count

int32

Numero di connettori in questa stazione. Tuttavia, poiché alcune stazioni di ricarica possono avere più connettori, ma essere in grado di ricaricare una sola auto alla volta (ad es.), il numero di connettori potrebbe essere superiore al numero totale di auto che possono essere ricaricate contemporaneamente.
connector_aggregation[]

ConnectorAggregation

Un elenco di aggregazioni di connettori di ricarica EV che contengono connettori dello stesso tipo e della stessa potenza di ricarica.

ConnectorAggregation

Informazioni sulla ricarica EV raggruppate per [type, max_charge_rate_kw]. Mostra l'aggregazione della ricarica EV dei connettori che hanno lo stesso tipo e la stessa potenza di ricarica massima in kW.

Campi
type

EVConnectorType

Il tipo di connettore di questa aggregazione.
max_charge_rate_kw

double

La potenza di ricarica massima statica in kW di ogni connettore nell'aggregazione.
count

int32

Numero di connettori in questa aggregazione.
availability_last_update_time

Timestamp

Il timestamp dell'ultimo aggiornamento delle informazioni sulla disponibilità del connettore in questa aggregazione.
available_count

int32

Numero di connettori in questa aggregazione attualmente disponibili.
out_of_service_count

int32

Numero di connettori in questa aggregazione attualmente fuori servizio.

EVConnectorType

Per ulteriori informazioni/contesto sui tipi di connettori di ricarica per veicoli elettrici, visita la pagina http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107.

Enum
EV_CONNECTOR_TYPE_UNSPECIFIED Connettore non specificato.
EV_CONNECTOR_TYPE_OTHER Altri tipi di connettori.
EV_CONNECTOR_TYPE_J1772 Connettore J1772 di tipo 1.
EV_CONNECTOR_TYPE_TYPE_2 Connettore IEC 62196 di tipo 2. Spesso indicato come MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Connettore di tipo CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Combined Charging System (AC e DC). In base al SAE. Connettore J-1772 di tipo 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 Combined Charging System (AC e DC). In base al connettore Mennekes di tipo 2
EV_CONNECTOR_TYPE_TESLA Il connettore TESLA generico. Si tratta di NACS in Nord America, ma può essere non NACS in altre parti del mondo (ad es. CCS Combo 2 (CCS2) o GB/T). Questo valore è meno rappresentativo di un tipo di connettore effettivo e rappresenta piuttosto la possibilità di ricaricare un veicolo del marchio Tesla presso una stazione di ricarica di proprietà di Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T Il tipo GB/T corrisponde allo standard GB/T in Cina. Questo tipo copre tutti i tipi GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Presa a muro non specificata.
EV_CONNECTOR_TYPE_NACS Il North American Charging System (NACS), standardizzato come SAE J3400.

FuelOptions

Le informazioni più recenti sulle opzioni di carburante in una stazione di servizio. Queste informazioni vengono aggiornate regolarmente.

Campi
fuel_prices[]

FuelPrice

L'ultimo prezzo del carburante noto per ogni tipo di carburante disponibile nella stazione di servizio. Esiste una voce per ogni tipo di carburante disponibile nella stazione di servizio. L'ordine non è importante.

FuelPrice

Informazioni sui prezzi del carburante per un determinato tipo.

Campi
type

FuelType

Il tipo di carburante.
price

Money

Il prezzo del carburante.
update_time

Timestamp

L'ora dell'ultimo aggiornamento del prezzo del carburante.

FuelType

Tipi di carburante.

Enum
FUEL_TYPE_UNSPECIFIED Tipo di carburante non specificato.
DIESEL Carburante diesel.
DIESEL_PLUS Diesel e carburante.
REGULAR_UNLEADED Benzina normale senza piombo.
MIDGRADE Benzina media.
PREMIUM Alta qualità
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG Gas di petrolio liquefatto.
E80 E 80.
E85 E 85.
E100 E 100.
METHANE Metano.
BIO_DIESEL Biodiesel.
TRUCK_DIESEL Camion diesel.

GetPhotoMediaRequest

Richiesta di recupero di una foto di un luogo utilizzando il nome di una risorsa foto.

Campi
name

string

Obbligatorio. Il nome della risorsa di un file multimediale di foto nel formato: places/{place_id}/photos/{photo_reference}/media.

Il nome della risorsa di una foto restituito nel campo photos.name di un oggetto Place ha il formato places/{place_id}/photos/{photo_reference}. Devi aggiungere /media alla fine della risorsa foto per ottenere il nome della risorsa multimediale della foto.
max_width_px

int32

Facoltativo. Specifica la larghezza massima desiderata, in pixel, dell'immagine. Se l'immagine è più piccola dei valori specificati, verrà restituita l'immagine originale. Se l'immagine è più grande in una delle due dimensioni, verrà ridimensionata in base alla dimensione più piccola, rispettando le proporzioni originali. Sia la proprietà max_height_px che la proprietà max_width_px accettano un numero intero compreso tra 1 e 4800, inclusi. Se il valore non rientra nell'intervallo consentito, viene restituito un errore INVALID_ARGUMENT.

È necessario specificare almeno un valore per max_height_px o max_width_px. Se non vengono specificati né max_height_px né max_width_px, viene restituito un errore INVALID_ARGUMENT.
max_height_px

int32

Facoltativo. Specifica l'altezza massima desiderata, in pixel, dell'immagine. Se l'immagine è più piccola dei valori specificati, verrà restituita l'immagine originale. Se l'immagine è più grande in una delle due dimensioni, verrà ridimensionata in base alla dimensione più piccola, rispettando le proporzioni originali. Sia la proprietà max_height_px che la proprietà max_width_px accettano un numero intero compreso tra 1 e 4800, inclusi. Se il valore non rientra nell'intervallo consentito, viene restituito un errore INVALID_ARGUMENT.

È necessario specificare almeno un valore per max_height_px o max_width_px. Se non vengono specificati né max_height_px né max_width_px, viene restituito un errore INVALID_ARGUMENT.
skip_http_redirect

bool

Facoltativo. Se impostato, salta il comportamento predefinito del reindirizzamento HTTP e mostra una risposta in formato di testo (ad esempio in formato JSON per il caso d'uso HTTP). Se non è impostato, verrà emesso un reindirizzamento HTTP per reindirizzare la chiamata ai contenuti multimediali dell'immagine. Questa opzione viene ignorata per le richieste non HTTP.

GetPlaceRequest

Richiesta di recupero di un luogo in base al nome della risorsa, che è una stringa nel formato places/{place_id}.

Campi
name

string

Obbligatorio. Il nome della risorsa di un luogo, nel formato places/{place_id}.
language_code

string

Facoltativo. I dettagli del luogo verranno visualizzati nella lingua preferita, se disponibile.

Elenco attuale delle lingue supportate: https://developers.google.com/maps/faq#languagesupport.
region_code

string

Facoltativo. Il codice Unicode paese/regione (CLDR) della località da cui proviene la richiesta. Questo parametro viene utilizzato per visualizzare i dettagli del luogo, ad esempio il nome del luogo specifico per la regione, se disponibile. Il parametro può influire sui risultati in base alla legge vigente. Per ulteriori informazioni, visita la pagina https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Tieni presente che i codici regione a tre cifre non sono attualmente supportati.
session_token

string

Facoltativo. Una stringa che identifica una sessione Autocomplete a fini di fatturazione. Deve essere una stringa base64 sicura per URL e nomi file con una lunghezza massima di 36 caratteri ASCII. In caso contrario, viene restituito un errore INVALID_ARGUMENT.

La sessione inizia quando l'utente inizia a digitare una query e termina quando seleziona un luogo e viene effettuata una chiamata a Dettagli dei luoghi o Convalida indirizzo. Ogni sessione può avere più query, seguite da una richiesta di dettagli sui luoghi o di convalida dell'indirizzo. Le credenziali utilizzate per ogni richiesta all'interno di una sessione devono appartenere allo stesso progetto della console Google Cloud. Al termine di una sessione, il token non è più valido; l'app deve generare un nuovo token per ogni sessione. Se il parametro session_token viene omesso o se riutilizzi un token sessione, la sessione viene addebitata come se non fosse stato fornito alcun token sessione (ogni richiesta viene fatturata separatamente).

Ti consigliamo di seguire le seguenti linee guida:

  • Utilizza i token di sessione per tutte le chiamate di completamento automatico dei luoghi.
  • Genera un nuovo token per ogni sessione. Si consiglia di utilizzare un UUID versione 4.
  • Assicurati che le credenziali utilizzate per tutte le richieste di completamento automatico dei luoghi, dei dettagli dei luoghi e di convalida dell'indirizzo all'interno di una sessione appartengano allo stesso progetto Cloud Console.
  • Assicurati di passare un token di sessione univoco per ogni nuova sessione. Se utilizzi lo stesso token per più sessioni, ogni richiesta verrà fatturata singolarmente.

Foto

Informazioni su una foto di un luogo.

Campi
name

string

Identificatore. Un riferimento che rappresenta la foto del luogo e che può essere utilizzato per cercarla di nuovo (chiamato anche nome della "risorsa" dell'API: places/{place_id}/photos/{photo}).
width_px

int32

La larghezza massima disponibile, in pixel.
height_px

int32

L'altezza massima disponibile, in pixel.
author_attributions[]

AuthorAttribution

Gli autori di questa foto.
flag_content_uri

string

Un link in cui gli utenti possono segnalare un problema con la foto.
google_maps_uri

string

Un link per mostrare la foto su Google Maps.

PhotoMedia

Un file multimediale di foto dall'API Places.

Campi
name

string

Il nome della risorsa di un file multimediale di foto nel formato: places/{place_id}/photos/{photo_reference}/media.
photo_uri

string

Un URI di breve durata che può essere utilizzato per visualizzare la foto.

Luogo

Tutte le informazioni che rappresentano un luogo.

Campi
name

string

Il nome della risorsa di questo luogo, in formato places/{place_id}. Può essere utilizzato per cercare il luogo.
id

string

L'identificatore univoco di un luogo.
display_name

LocalizedText

Il nome localizzato del luogo, adatto come breve descrizione leggibile. Ad esempio, "Google Sydney", "Starbucks", "Pyrmont" e così via.
types[]

string

Un insieme di tag di tipo per questo risultato. Ad esempio, "politico" e "località". Per l'elenco completo dei valori possibili, consulta le tabelle A e B all'indirizzo https://developers.google.com/maps/documentation/places/web-service/place-types
primary_type

string

Il tipo principale del risultato specificato. Questo tipo deve essere uno dei tipi supportati dall'API Places. Ad esempio, "ristorante", "bar", "aeroporto" e così via. Un luogo può avere un solo tipo principale. Per l'elenco completo dei valori possibili, consulta le tabelle A e B all'indirizzo https://developers.google.com/maps/documentation/places/web-service/place-types
primary_type_display_name

LocalizedText

Il nome visualizzato del tipo principale, localizzato nella lingua della richiesta, se applicabile. Per l'elenco completo dei valori possibili, consulta le tabelle A e B all'indirizzo https://developers.google.com/maps/documentation/places/web-service/place-types
national_phone_number

string

Un numero di telefono leggibile per il luogo, in formato nazionale.
international_phone_number

string

Un numero di telefono leggibile per il luogo, in formato internazionale.
formatted_address

string

Un indirizzo completo e leggibile per questo luogo.
short_formatted_address

string

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

AddressComponent

Componenti ripetuti per ogni livello di località. Tieni presente i seguenti aspetti relativi all'array address_components[]: - L'array di componenti dell'indirizzo può contenere più componenti rispetto all'indirizzo_formattato. - L'array non include necessariamente tutte le entità politiche che contengono un indirizzo, a parte quelle incluse in formatted_address. Per recuperare tutte le entità politiche che contengono un indirizzo specifico, devi utilizzare la geocodifica inversa, passando la latitudine/longitudine dell'indirizzo come parametro alla richiesta. - Non è garantito che il formato della risposta rimanga invariato tra le richieste. In particolare, il numero di elementi address_components varia in base all'indirizzo richiesto e può cambiare nel tempo per lo stesso indirizzo. Un componente può cambiare posizione nell'array. Il tipo di componente può cambiare. Un determinato componente potrebbe non essere presente in una risposta successiva.
plus_code

PlusCode

Plus Code della latitudine/longitudine della posizione del luogo.
location

LatLng

La posizione di questo luogo.
viewport

Viewport

Un'area visibile adatta per la visualizzazione del luogo su una mappa di dimensioni medie. Questo viewport non deve essere utilizzato come confine fisico o area coperta dal servizio dell'attività.
rating

double

Una valutazione compresa tra 1,0 e 5,0, in base alle recensioni degli utenti su questo luogo.
google_maps_uri

string

Un URL che fornisce ulteriori informazioni su questo luogo.
website_uri

string

Il sito web autorevole per questo luogo, ad esempio la home page di un'attività. Tieni presente che per i luoghi che fanno parte di una catena (ad es. un negozio IKEA), in genere si tratta del sito web del singolo negozio, non della catena nel suo complesso.
reviews[]

Review

Elenco di recensioni su questo luogo, ordinate per pertinenza. È possibile restituire un massimo di 5 recensioni.
regular_opening_hours

OpeningHours

Gli orari di apertura normali. Tieni presente che se un luogo è sempre aperto (24 ore), il campo close non verrà impostato. I clienti possono fare affidamento sul fatto che l'apertura continua (24 ore) sia rappresentata come un periodo [open][google.maps.places.v1.Place.OpeningHours.Period.open] contenente [day][Point.day] con valore 0, [hour][Point.hour] con valore 0 e [minute][Point.minute] con valore 0.
time_zone

TimeZone

Fuso orario del database IANA Time Zone. Ad esempio "America/New_York".
photos[]

Photo

Informazioni (inclusi i riferimenti) sulle foto di questo luogo. È possibile restituire un massimo di 10 foto.
adr_format_address

string

L'indirizzo del luogo nel microformato adr: http://microformats.org/wiki/adr.
business_status

BusinessStatus

Lo stato dell'attività per il luogo.
price_level

PriceLevel

Il livello di prezzo del luogo.
attributions[]

Attribution

Un insieme di fornitori di dati che devono essere mostrati con questo risultato.
icon_mask_base_uri

string

Un URL troncato a una maschera di icone. L'utente può accedere a diversi tipi di icone aggiungendo il suffisso del tipo alla fine (ad es. ".svg" o ".png").
icon_background_color

string

Colore di sfondo per icon_mask in formato esadecimale, ad esempio #909CE1.
current_opening_hours

OpeningHours

L'orario di apertura per i prossimi sette giorni (incluso oggi). Il periodo di tempo inizia a mezzanotte della data della richiesta e termina alle 23:59 sei giorni dopo. Questo campo include il sottocampo special_days di tutte le ore, impostato per le date con orari eccezionali.
current_secondary_opening_hours[]

OpeningHours

Contiene un array di voci per i sette giorni successivi, incluse informazioni sugli orari secondari di un'attività. Gli orari secondari sono diversi da quelli principali di un'attività. Ad esempio, un ristorante può specificare come orari secondari quelli del servizio in auto o della consegna a domicilio. Questo campo compila il sottocampo type, che viene ricavato da un elenco predefinito di tipi di orario di apertura (ad esempio DRIVE_THROUGH, PICKUP o TAKEOUT) in base ai tipi di luogo. Questo campo include il sottocampo special_days di tutte le ore, impostato per le date con orari eccezionali.
regular_secondary_opening_hours[]

OpeningHours

Contiene un array di voci per informazioni sugli orari secondari regolari di un'attività. Gli orari secondari sono diversi da quelli principali di un'attività. Ad esempio, un ristorante può specificare come orari secondari quelli del servizio in auto o della consegna a domicilio. Questo campo compila il sottocampo type, che viene ricavato da un elenco predefinito di tipi di orario di apertura (ad esempio DRIVE_THROUGH, PICKUP o TAKEOUT) in base ai tipi di luogo.
editorial_summary

LocalizedText

Contiene un riepilogo del luogo. Un riepilogo è costituito da una panoramica testuale e include anche il codice lingua, se applicabile. Il testo del riepilogo deve essere presentato così com'è e non può essere modificato o alterato.
payment_options

PaymentOptions

Le opzioni di pagamento accettate dal luogo. Se i dati di un'opzione di pagamento non sono disponibili, il campo dell'opzione di pagamento non verrà impostato.
parking_options

ParkingOptions

Opzioni di parcheggio offerte dalla struttura.
sub_destinations[]

SubDestination

Un elenco di destinazioni secondarie correlate al luogo.
fuel_options

FuelOptions

Le informazioni più recenti sulle opzioni di carburante in una stazione di servizio. Queste informazioni vengono aggiornate regolarmente.
ev_charge_options

EVChargeOptions

Informazioni sulle opzioni di ricarica EV.
generative_summary

GenerativeSummary

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riepilogo del luogo creato con l'IA.
area_summary

AreaSummary

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riepilogo dell'area in cui si trova il luogo creato con l'IA.
containing_places[]

ContainingPlace

Elenco di località in cui si trova la località corrente.
address_descriptor

AddressDescriptor

Il descrittore dell'indirizzo del luogo. I descrittori dell'indirizzo includono informazioni aggiuntive che aiutano a descrivere una località utilizzando punti di riferimento e aree. Consulta la copertura regionale dei descrittori degli indirizzi all'indirizzo https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
price_range

PriceRange

La fascia di prezzo associata a un luogo.
utc_offset_minutes

int32

Numero di minuti di differenza tra il fuso orario di questo luogo e UTC. Questo valore è espresso in minuti per supportare i fusi orari con uno scarto di frazioni di un'ora, ad esempio X ore e 15 minuti.
user_rating_count

int32

Il numero totale di recensioni (con o senza testo) per questo luogo.
takeout

bool

Specifica se l'attività supporta l'estrazione.
delivery

bool

Specifica se l'attività supporta la consegna.
dine_in

bool

Specifica se l'attività supporta opzioni di posti a sedere al chiuso o all'aperto.
curbside_pickup

bool

Specifica se l'attività supporta il ritiro all'esterno.
reservable

bool

Specifica se il luogo supporta le prenotazioni.
serves_breakfast

bool

Specifica se il luogo serve la colazione.
serves_lunch

bool

Specifica se il luogo serve il pranzo.
serves_dinner

bool

Specifica se il luogo serve la cena.
serves_beer

bool

Specifica se il luogo serve birra.
serves_wine

bool

Specifica se il luogo serve vino.
serves_brunch

bool

Specifica se il luogo serve il brunch.
serves_vegetarian_food

bool

Specifica se il luogo serve cibo vegetariano.
outdoor_seating

bool

Il locale offre posti a sedere all'aperto.
live_music

bool

Il locale offre musica dal vivo.
menu_for_children

bool

Il locale offre un menu per bambini.
serves_cocktails

bool

Il locale serve cocktail.
serves_dessert

bool

Il locale serve dessert.
serves_coffee

bool

Il locale serve caffè.
good_for_children

bool

Il posto è adatto ai bambini.
allows_dogs

bool

Il luogo ammette i cani.
restroom

bool

Il luogo dispone di toilette.
good_for_groups

bool

Il luogo può ospitare gruppi.
good_for_watching_sports

bool

Il luogo è adatto per guardare sport.
accessibility_options

AccessibilityOptions

Informazioni sulle opzioni di accessibilità offerte da un luogo.
pure_service_area_business

bool

Indica se il luogo è un'attività con area coperta dal servizio. Un'attività al domicilio del cliente è un'attività che effettua consegne a domicilio o raggiunge direttamente i clienti, ma non presta servizio ai clienti presso l'indirizzo aziendale. Ad esempio, attività come servizi di pulizia o idraulici. Queste attività potrebbero non avere un indirizzo fisico o una sede su Google Maps.

AccessibilityOptions

Informazioni sulle opzioni di accessibilità offerte da un luogo.

Campi
wheelchair_accessible_parking

bool

La struttura offre un parcheggio accessibile in sedia a rotelle.
wheelchair_accessible_entrance

bool

I luoghi dispongono di un ingresso accessibile in sedia a rotelle.
wheelchair_accessible_restroom

bool

Il luogo dispone di una toilette accessibile in sedia a rotelle.
wheelchair_accessible_seating

bool

Il luogo dispone di posti accessibili in sedia a rotelle.

AddressComponent

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

Campi
long_text

string

La descrizione completa del testo o il nome del componente dell'indirizzo. Ad esempio, un componente dell'indirizzo per il paese Australia potrebbe avere un valore long_name di "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 un valore short_name di "AU".
types[]

string

Un array che indica i tipi di componenti dell'indirizzo.
language_code

string

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

AreaSummary

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riepilogo dell'area in cui si trova il luogo creato con l'IA.

Campi
content_blocks[]

ContentBlock

Blocchi di contenuti che compongono il riepilogo dell'area. Ogni blocco ha un argomento separato relativo all'area.
flag_content_uri

string

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

Attribuzione

Informazioni sui fornitori di dati di questo luogo.

Campi
provider

string

Nome del fornitore di dati del luogo.
provider_uri

string

URI del fornitore di dati del luogo.

BusinessStatus

Stato dell'attività per il luogo.

Enum
BUSINESS_STATUS_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
OPERATIONAL L'attività è operativa, ma non necessariamente aperta al momento.
CLOSED_TEMPORARILY L'attività è temporaneamente chiusa.
CLOSED_PERMANENTLY L'attività è chiusa definitivamente.

ContainingPlace

Informazioni sul luogo in cui si trova questo luogo.

Campi
name

string

Il nome della risorsa del luogo in cui si trova questo luogo.
id

string

L'ID luogo in cui si trova il luogo.

GenerativeSummary

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riepilogo del luogo creato con l'IA.

Campi
overview

LocalizedText

La panoramica del luogo.
overview_flag_content_uri

string

Un link in cui gli utenti possono segnalare un problema con il riepilogo della panoramica.
description

LocalizedText

La descrizione dettagliata del luogo.
description_flag_content_uri

string

Un link in cui gli utenti possono segnalare un problema con il riepilogo della descrizione.
references

References

Riferimenti utilizzati per generare la descrizione del riepilogo.

OpeningHours

Informazioni sull'orario di apertura del luogo.

Campi
periods[]

Period

I periodi in cui il luogo è aperto durante la settimana. I periodi sono in ordine cronologico, a partire da domenica nel fuso orario locale della località. Un valore vuoto (ma non assente) indica un luogo che non è mai aperto, ad esempio perché è chiuso temporaneamente per lavori di ristrutturazione.
weekday_descriptions[]

string

Stringhe localizzate che descrivono gli orari di apertura del luogo, una stringa per ogni giorno della settimana. Sarà vuoto se l'orario è sconosciuto o non è stato possibile convertirlo in testo localizzato. Esempio: "Dom: 18:00-06:00"
secondary_hours_type

SecondaryHoursType

Una stringa di tipo utilizzata per identificare il tipo di ore secondarie.
special_days[]

SpecialDay

Informazioni strutturate per i giorni speciali che rientrano nel periodo coperto dagli orari di apertura restituiti. I giorni speciali sono giorni che potrebbero influire sull'orario di apertura di un luogo, ad esempio il giorno di Natale. Imposta per current_opening_hours e current_secondary_opening_hours se sono presenti orari eccezionali.
next_open_time

Timestamp

La prossima volta che inizia il periodo di apertura attuale fino a 7 giorni nel futuro. Questo campo viene compilato solo se il periodo di apertura non è attivo al momento della pubblicazione della richiesta.
next_close_time

Timestamp

La prossima volta che termina il periodo dell'orario di apertura attuale fino a 7 giorni nel futuro. Questo campo viene compilato solo se il periodo di apertura è attivo al momento della pubblicazione della richiesta.
open_now

bool

Indica se il periodo di apertura è attualmente attivo. Per gli orari di apertura normali e quelli attuali, questo campo indica se il luogo è aperto. Per gli orari di apertura secondari e gli orari di apertura secondari attuali, questo campo indica se gli orari secondari di questo luogo sono attivi.

Periodo

Un periodo in cui il luogo rimane nello stato open_now.

Campi
open

Point

L'ora in cui il luogo inizia a essere aperto.
close

Point

L'ora in cui il luogo inizia a essere chiuso.

Punto

Punti di variazione dello stato.

Campi
date

Date

Data nel fuso orario locale del luogo.
truncated

bool

Indica se questo endpoint è stato troncato o meno. Il troncamento si verifica quando le ore reali non rientrano nell'intervallo di ore che siamo disposti a restituire, quindi le tronchiamo in base a questi limiti. In questo modo vengono restituite al massimo 24 * 7 ore dalla mezzanotte del giorno della richiesta.
day

int32

Un giorno della settimana, come numero intero compreso tra 0 e 6. 0 è domenica, 1 è lunedì e così via.
hour

int32

L'ora in formato 24 ore. Intervallo da 0 a 23.
minute

int32

Il minuto. Intervallo da 0 a 59.

SecondaryHoursType

Un tipo utilizzato per identificare il tipo di ore secondarie.

Enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Valore predefinito quando non è specificato il tipo di ora secondaria.
DRIVE_THROUGH L'orario di apertura del servizio drive-through per banche, ristoranti o farmacie.
HAPPY_HOUR L'happy hour.
DELIVERY L'ora di consegna.
TAKEOUT L'ora di ritiro.
KITCHEN L'ora della cucina.
BREAKFAST L'ora della colazione.
LUNCH L'ora di pranzo.
DINNER L'ora della cena.
BRUNCH L'ora del brunch.
PICKUP L'ora di ritiro.
ACCESS L'orario di accesso ai luoghi di stoccaggio.
SENIOR_HOURS Gli orari speciali per gli anziani.
ONLINE_SERVICE_HOURS Gli orari di servizio online.

SpecialDay

Informazioni strutturate per i giorni speciali che rientrano nel periodo coperto dagli orari di apertura restituiti. I giorni speciali sono giorni che potrebbero influire sull'orario di apertura di un luogo, ad esempio il giorno di Natale.

Campi
date

Date

La data di questo giorno speciale.

ParkingOptions

Informazioni sulle opzioni di parcheggio per il luogo. Un parcheggio potrebbe supportare più di un'opzione contemporaneamente.

Campi
free_parking_lot

bool

La struttura offre parcheggi gratuiti.
paid_parking_lot

bool

Il luogo offre parcheggi a pagamento.
free_street_parking

bool

Il parcheggio in strada è senza costi.
paid_street_parking

bool

La struttura offre parcheggio in strada a pagamento.
valet_parking

bool

La struttura offre il servizio di parcheggio.
free_garage_parking

bool

Il parcheggio in garage è senza costi.
paid_garage_parking

bool

La struttura offre un garage a pagamento.

PaymentOptions

Le opzioni di pagamento accettate dal luogo.

Campi
accepts_credit_cards

bool

Il luogo accetta carte di credito come forma di pagamento.
accepts_debit_cards

bool

Il luogo accetta carte di debito come metodo di pagamento.
accepts_cash_only

bool

Il luogo accetta solo pagamenti in contanti. I luoghi con questo attributo potrebbero comunque accettare altri metodi di pagamento.
accepts_nfc

bool

Il luogo accetta pagamenti NFC.

PlusCode

Il Plus Code (http://plus.codes) è un riferimento di posizione con due formati: il codice globale che definisce un rettangolo di 14 m x 14 m (1/8000 di grado) o più piccolo e il 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 gradi per 1/8000 gradi (~14 per 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.

SubDestination

Le sottodestinazioni sono luoghi specifici associati a un luogo principale. Forniscono destinazioni più specifiche per gli utenti che cercano un luogo grande o complesso, come un aeroporto, un parco nazionale, un'università o uno stadio. Ad esempio, le destinazioni secondarie in un aeroporto potrebbero includere parcheggi e terminal associati. Le destinazioni secondarie restituiscono l'ID luogo e il nome della risorsa luogo, che possono essere utilizzati nelle richieste Places Details (New) successive per recuperare dettagli più completi, tra cui il nome visualizzato e la posizione della destinazione secondaria.

Campi
name

string

Il nome della risorsa della destinazione secondaria.
id

string

L'ID posizione della destinazione secondaria.

Polilinea

Una polilinea del percorso. Supporta solo un polilinea codificato, che può essere passato come stringa e include la compressione con una perdita minima. Questa è l'uscita predefinita dell'API Routes.

Campi
Campo unione polyline_type. Racchiude il tipo di polilinea. Il valore predefinito dell'output dell'API Routes è encoded_polyline. polyline_type può essere solo uno dei seguenti:
encoded_polyline

string

Una polilinea codificata, restituita dall'API Routes per impostazione predefinita. Consulta gli strumenti di codifica e decodifica.

PriceLevel

Il livello di prezzo del luogo.

Enum
PRICE_LEVEL_UNSPECIFIED Il livello del prezzo del luogo non è specificato o è sconosciuto.
PRICE_LEVEL_FREE Il luogo offre servizi senza costi.
PRICE_LEVEL_INEXPENSIVE Il luogo offre servizi economici.
PRICE_LEVEL_MODERATE Il luogo offre servizi a prezzi moderati.
PRICE_LEVEL_EXPENSIVE Il luogo offre servizi costosi.
PRICE_LEVEL_VERY_EXPENSIVE Il luogo offre servizi molto costosi.

PriceRange

La fascia di prezzo associata a un luogo. end_price potrebbe non essere impostato, il che indica un intervallo senza limite superiore (ad es. "Più di 100 $").

Campi
start_price

Money

La fascia di prezzo più bassa (inclusa). Il prezzo deve essere uguale o superiore a questo importo.
end_price

Money

La fascia di prezzo più alta (esclusiva). Il prezzo deve essere inferiore a questo importo.

Riferimenti

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riferimento a cui si riferiscono i contenuti generativi.

Campi
reviews[]

Review

Recensioni che fungono da riferimenti.
places[]

string

L'elenco dei nomi delle risorse dei luoghi a cui si fa riferimento. Questo nome può essere utilizzato in altre API che accettano nomi di risorse Place.

Rivedi

Informazioni su una recensione di un luogo.

Campi
name

string

Un riferimento che rappresenta la recensione del luogo e che può essere utilizzato per cercarla di nuovo (chiamato anche nome della "risorsa" dell'API: places/{place_id}/reviews/{review}).
relative_publish_time_description

string

Una stringa di ora recente formattata, che esprime l'ora della recensione rispetto all'ora corrente in una forma appropriata per la lingua e il paese.
text

LocalizedText

Il testo localizzato della recensione.
original_text

LocalizedText

Il testo della recensione nella lingua originale.
rating

double

Un numero compreso tra 1,0 e 5,0, chiamato anche numero di stelle.
author_attribution

AuthorAttribution

L'autore di questa recensione.
publish_time

Timestamp

Timestamp della recensione.
flag_content_uri

string

Un link tramite il quale gli utenti possono segnalare un problema con la recensione.
google_maps_uri

string

Un link per mostrare la recensione su Google Maps.

RouteModifiers

Incapsula un insieme di condizioni facoltative da soddisfare durante il calcolo dei percorsi.

Campi
avoid_tolls

bool

Facoltativo. Se impostato su true, evita le strade a pedaggio, se possibile, dando la preferenza ai percorsi che non le contengono. Si applica solo a DRIVE e TWO_WHEELER TravelMode.
avoid_highways

bool

Facoltativo. Se impostato su true, evita le autostrade, se possibile, dando la preferenza ai percorsi che non le contengono. Si applica solo a DRIVE e TWO_WHEELER TravelMode.
avoid_ferries

bool

Facoltativo. Se impostato su true, evita i traghetti, se possibile, dando la preferenza ai percorsi che non li contengono. Si applica solo a DRIVE e TWO_WHEELER TravelMode.
avoid_indoor

bool

Facoltativo. Se impostato su true, evita la navigazione al chiuso, se possibile, dando la preferenza ai percorsi che non contengono navigazione al chiuso. Si applica solo al WALK TravelMode.

RoutingParameters

Parametri per configurare i calcoli del percorso per i luoghi nella risposta, sia lungo un percorso (dove il ranking dei risultati sarà influenzato) sia per calcolare i tempi di percorrenza nei risultati.

Campi
origin

LatLng

Facoltativo. Un'origine di routing esplicita che sostituisce l'origine definita nel polilinea. Per impostazione predefinita, viene utilizzata l'origine del polilinea.
travel_mode

TravelMode

Facoltativo. La modalità di viaggio.
route_modifiers

RouteModifiers

Facoltativo. I modificatori di percorso.
routing_preference

RoutingPreference

Facoltativo. Specifica come calcolare i riepiloghi di routing. Il server tenta di utilizzare la preferenza di routing selezionata per calcolare il percorso. La preferenza di routing in base al traffico è disponibile solo per DRIVE o TWO_WHEELER travelMode.

RoutingPreference

Un insieme di valori che specificano i fattori da prendere in considerazione per il calcolo del percorso.

Enum
ROUTING_PREFERENCE_UNSPECIFIED Nessuna preferenza di routing specificata. Il valore predefinito è TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Calcola i percorsi senza tenere conto delle condizioni del traffico in tempo reale. Adatta quando le condizioni del traffico non sono importanti o non sono applicabili. L'utilizzo di questo valore produce la latenza più bassa. Nota: per TravelMode DRIVE e TWO_WHEELER, il percorso e la durata scelti si basano sulla rete stradale e sulle condizioni di traffico medie indipendenti dal tempo, non sulle condizioni stradali attuali. Di conseguenza, i percorsi potrebbero includere strade temporaneamente chiuse. I risultati di una determinata richiesta possono variare nel tempo a causa di cambiamenti nella rete stradale, condizioni di traffico medio aggiornate e la natura distribuita del servizio. I risultati possono variare anche tra percorsi quasi equivalenti in qualsiasi momento o con qualsiasi frequenza.
TRAFFIC_AWARE Calcola i percorsi tenendo conto delle condizioni del traffico in tempo reale. A differenza di TRAFFIC_AWARE_OPTIMAL, vengono applicate alcune ottimizzazioni per ridurre notevolmente la latenza.
TRAFFIC_AWARE_OPTIMAL Calcola i percorsi tenendo conto delle condizioni del traffico in tempo reale, senza applicare la maggior parte delle ottimizzazioni del rendimento. L'utilizzo di questo valore produce la latenza più elevata.

RoutingSummary

La durata e la distanza dall'origine del percorso a un luogo nella risposta e una seconda tratta da quel luogo alla destinazione, se richiesta. Nota:l'aggiunta di routingSummaries nella maschera di campo senza includere anche il parametro routingParameters.origin o searchAlongRouteParameters.polyline.encodedPolyline nella richiesta causa un errore.

Campi
legs[]

Leg

Le tappe del viaggio.

Quando calcoli la durata e la distanza del viaggio da un'origine impostata, legs contiene un singolo tratto contenente la durata e la distanza dall'origine alla destinazione. Quando esegui una ricerca lungo il percorso, legs contiene due tratti: uno dall'origine al luogo e uno dal luogo alla destinazione.
directions_uri

string

Un link per mostrare le indicazioni stradali su Google Maps utilizzando i waypoint del riepilogo del percorso specificato. Non è garantito che il percorso generato da questo link sia lo stesso utilizzato per generare il riepilogo del routing. Il link utilizza le informazioni fornite nella richiesta, da campi tra cui routingParameters e searchAlongRouteParameters, se applicabili, per generare il link alle indicazioni stradali.

Gamba

Una tratta è una singola parte di un viaggio da una località all'altra.

Campi
duration

Duration

Il tempo necessario per completare questo tratto del viaggio.
distance_meters

int32

La distanza di questo tratto del viaggio.

SearchNearbyRequest

Richiedi il proto per la ricerca nelle vicinanze.

Campi
language_code

string

I dettagli del luogo verranno visualizzati nella lingua preferita, se disponibile. Se il codice lingua non è specificato o non è riconosciuto, è possibile che vengano restituiti i dettagli del luogo in qualsiasi lingua, con una preferenza per l'inglese, se esistono.

Elenco attuale delle lingue supportate: https://developers.google.com/maps/faq#languagesupport.
region_code

string

Il codice Unicode paese/regione (CLDR) della località da cui proviene la richiesta. Questo parametro viene utilizzato per visualizzare i dettagli del luogo, ad esempio il nome del luogo specifico per la regione, se disponibile. Il parametro può influire sui risultati in base alla legge vigente.

Per ulteriori informazioni, visita la pagina https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Tieni presente che i codici regione a tre cifre non sono attualmente supportati.
included_types[]

string

Tipo di luogo incluso (ad es. "ristorante" o "stazioni_di_servizio") da https://developers.google.com/maps/documentation/places/web-service/place-types.

È possibile specificare fino a 50 tipi della Tabella A.

Se sono presenti tipi in conflitto, ovvero un tipo compare sia in included_types che in excluded_types, viene restituito un errore INVALID_ARGUMENT.

Se per un tipo di luogo vengono specificate più limitazioni di tipo, vengono restituiti solo i luoghi che soddisfano tutte le limitazioni. Ad esempio, se abbiamo {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, i luoghi restituiti forniscono servizi correlati ai "ristoranti", ma non operano principalmente come "ristoranti".
excluded_types[]

string

Tipo di luogo escluso (ad es. "ristorante" o "stazioni_di_servizio") da https://developers.google.com/maps/documentation/places/web-service/place-types.

È possibile specificare fino a 50 tipi della Tabella A.

Se il client fornisce sia included_types (ad es. ristorante) che excluded_types (ad es. bar), la risposta deve includere i luoghi che sono ristoranti, ma non bar. La risposta include i luoghi che corrispondono ad almeno uno dei tipi inclusi e a nessuno dei tipi esclusi.

Se sono presenti tipi in conflitto, ovvero un tipo compare sia in included_types che in excluded_types, viene restituito un errore INVALID_ARGUMENT.

Se per un tipo di luogo vengono specificate più limitazioni di tipo, vengono restituiti solo i luoghi che soddisfano tutte le limitazioni. Ad esempio, se abbiamo {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, i luoghi restituiti forniscono servizi correlati ai "ristoranti", ma non operano principalmente come "ristoranti".
included_primary_types[]

string

Tipo di luogo principale incluso (ad es. "ristorante" o "stazione_di_servizio") da https://developers.google.com/maps/documentation/places/web-service/place-types. A un luogo può essere associato un solo tipo principale dalla tabella dei tipi supportati.

È possibile specificare fino a 50 tipi della Tabella A.

Se sono presenti tipi principali in conflitto, ovvero un tipo compare sia in included_primary_types che in excluded_primary_types, viene restituito un errore INVALID_ARGUMENT.

Se per un tipo di luogo vengono specificate più limitazioni di tipo, vengono restituiti solo i luoghi che soddisfano tutte le limitazioni. Ad esempio, se abbiamo {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, i luoghi restituiti forniscono servizi correlati ai "ristoranti", ma non operano principalmente come "ristoranti".
excluded_primary_types[]

string

Tipo di luogo principale escluso (ad es. "ristorante" o "stazione_di_servizio") da https://developers.google.com/maps/documentation/places/web-service/place-types.

È possibile specificare fino a 50 tipi della Tabella A.

Se sono presenti tipi principali in conflitto, ovvero un tipo compare sia in included_primary_types che in excluded_primary_types, viene restituito un errore INVALID_ARGUMENT.

Se per un tipo di luogo vengono specificate più limitazioni di tipo, vengono restituiti solo i luoghi che soddisfano tutte le limitazioni. Ad esempio, se abbiamo {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, i luoghi restituiti forniscono servizi correlati ai "ristoranti", ma non operano principalmente come "ristoranti".
max_result_count

int32

Il numero massimo di risultati da restituire. Deve essere compreso tra 1 e 20 (valore predefinito), inclusi. Se il numero non è impostato, viene utilizzato il limite superiore. Se il numero è impostato su un valore negativo o supera il limite superiore, viene restituito un errore INVALID_ARGUMENT.
location_restriction

LocationRestriction

Obbligatorio. La regione in cui cercare.
rank_preference

RankPreference

La modalità di classificazione dei risultati nella risposta.
routing_parameters

RoutingParameters

Facoltativo. Parametri che influiscono sul routing ai risultati di ricerca.

LocationRestriction

La regione in cui cercare.

Campi

Campo unione type.

type può essere solo uno dei seguenti:
circle

Circle

Un cerchio definito dal punto centrale e dal raggio.

RankPreference

La modalità di classificazione dei risultati nella risposta.

Enum
RANK_PREFERENCE_UNSPECIFIED Valore RankPreference non impostato. Per impostazione predefinita, verrà utilizzato il ranking per POPOLARITÀ.
DISTANCE Ordina i risultati in base alla distanza.
POPULARITY Classifica i risultati in base alla popolarità.

SearchNearbyResponse

Proto di risposta per la ricerca nelle vicinanze.

Campi
places[]

Place

Un elenco di luoghi che soddisfano i requisiti dell'utente, come tipi di luoghi, numero di luoghi e limitazioni specifiche per la località.
routing_summaries[]

RoutingSummary

Un elenco di riepiloghi di routing in cui ogni voce è associata al luogo corrispondente nello stesso indice del campo places. Se il riepilogo del percorso non è disponibile per uno dei luoghi, conterrà una voce vuota. Questo elenco deve contenere tante voci quante quelle dell'elenco dei luoghi, se richiesto.

SearchTextRequest

Richiedi il proto per SearchText.

Campi
text_query

string

Obbligatorio. La query di testo per la ricerca di testo.
language_code

string

I dettagli del luogo verranno visualizzati nella lingua preferita, se disponibile. Se il codice lingua non è specificato o non è riconosciuto, è possibile che vengano restituiti i dettagli del luogo in qualsiasi lingua, con una preferenza per l'inglese, se esistono.

Elenco attuale delle lingue supportate: https://developers.google.com/maps/faq#languagesupport.
region_code

string

Il codice Unicode paese/regione (CLDR) della località da cui proviene la richiesta. Questo parametro viene utilizzato per visualizzare i dettagli del luogo, ad esempio il nome del luogo specifico per la regione, se disponibile. Il parametro può influire sui risultati in base alla legge vigente.

Per ulteriori informazioni, visita la pagina https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Tieni presente che i codici regione a tre cifre non sono attualmente supportati.
rank_preference

RankPreference

La modalità di classificazione dei risultati nella risposta.
included_type

string

Il tipo di luogo richiesto. Elenco completo dei tipi supportati: https://developers.google.com/maps/documentation/places/web-service/place-types. Supporta solo un tipo incluso.
open_now

bool

Utilizzato per limitare la ricerca ai luoghi attualmente aperti. Il valore predefinito è false.
min_rating

double

Filtra i risultati la cui valutazione media degli utenti è inferiore a questo limite. Un valore valido deve essere un numero con virgola mobile compreso tra 0 e 5 (inclusi) a una cadenza di 0,5, ad esempio [0, 0,5, 1,0, ... , 5,0] inclusi. La valutazione in input verrà arrotondata per eccesso al valore 0,5 più vicino. Ad esempio, una valutazione di 0,6 eliminerà tutti i risultati con una valutazione inferiore a 1,0.
max_result_count
(deprecated)

int32

Deprecato: utilizza page_size.

Il numero massimo di risultati per pagina che possono essere restituiti. Se il numero di risultati disponibili è maggiore di max_result_count, viene restituito un next_page_token che può essere passato a page_token per ottenere la pagina successiva dei risultati nelle richieste successive. Se non viene fornito alcun valore o viene fornito il valore 0, viene utilizzato un valore predefinito di 20. Il valore massimo è 20; i valori superiori a 20 verranno forzati a 20. I valori negativi restituiranno un errore INVALID_ARGUMENT.

Se vengono specificati sia max_result_count che page_size, max_result_count verrà ignorato.
page_size

int32

Facoltativo. Il numero massimo di risultati per pagina che possono essere restituiti. Se il numero di risultati disponibili è maggiore di page_size, viene restituito un next_page_token che può essere passato a page_token per ottenere la pagina successiva dei risultati nelle richieste successive. Se non viene fornito alcun valore o viene fornito il valore 0, viene utilizzato un valore predefinito di 20. Il valore massimo è 20; i valori superiori a 20 verranno impostati su 20. I valori negativi restituiranno un errore INVALID_ARGUMENT.

Se vengono specificati sia max_result_count che page_size, max_result_count verrà ignorato.
page_token

string

Facoltativo. Un token di pagina ricevuto da una precedente chiamata TextSearch. Fornisci questo valore per recuperare la pagina successiva.

Quando esegui la paginazione, tutti i parametri diversi da page_token, page_size e max_result_count forniti a TextSearch devono corrispondere alla chiamata iniziale che ha fornito il token pagina. In caso contrario, viene restituito un errore INVALID_ARGUMENT.
price_levels[]

PriceLevel

Utilizzato per limitare la ricerca ai luoghi contrassegnati come appartenenti a determinati livelli di prezzo. Gli utenti possono scegliere qualsiasi combinazione di livelli di prezzo. Per impostazione predefinita, vengono selezionati tutti i livelli di prezzo.
strict_type_filtering

bool

Utilizzato per impostare un filtro di tipo rigoroso per included_type. Se impostato su true, verranno restituiti solo risultati dello stesso tipo. Il valore predefinito è false.
location_bias

LocationBias

La regione in cui cercare. Questa località funge da bias, il che significa che potrebbero essere restituiti risultati relativi a una determinata località. Non può essere impostato insieme a location_restriction.
location_restriction

LocationRestriction

La regione in cui cercare. Questa località funge da limitazione, il che significa che i risultati al di fuori della località indicata non verranno restituiti. Non può essere impostato insieme a location_bias.
ev_options

EVOptions

Facoltativo. Imposta le opzioni EV disponibili per la ricerca di una richiesta di ricerca di luoghi.
routing_parameters

RoutingParameters

Facoltativo. Parametri aggiuntivi per il routing ai risultati.
search_along_route_parameters

SearchAlongRouteParameters

Facoltativo. Proto di parametri aggiuntivi per la ricerca lungo un percorso.
include_pure_service_area_businesses

bool

Facoltativo. Includi le attività al domicilio del cliente se il campo è impostato su true. Un'attività al domicilio del cliente è un'attività che effettua consegne a domicilio o raggiunge direttamente i clienti, ma non presta servizio ai clienti presso l'indirizzo aziendale. Ad esempio, attività come servizi di pulizia o idraulici. Queste attività non hanno un indirizzo fisico o una sede su Google Maps. Per queste attività, Places non restituirà campi tra cui location, plus_code e altri campi relativi alla posizione.

EVOptions

Opzioni EV disponibili per la ricerca di una richiesta di ricerca di luoghi.

Campi
minimum_charging_rate_kw

double

Facoltativo. Potenza di ricarica minima richiesta in kilowatt. Un luogo con una tariffa di ricarica inferiore a quella specificata viene escluso.
connector_types[]

EVConnectorType

Facoltativo. L'elenco dei tipi di connettori EV preferiti. Un luogo che non supporta nessuno dei tipi di connettore elencati viene escluso.

LocationBias

La regione in cui cercare. Questa località funge da bias, il che significa che potrebbero essere restituiti risultati relativi a una determinata località.

Campi

Campo unione type.

type può essere solo uno dei seguenti:
rectangle

Viewport

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

Circle

Un cerchio definito dal punto centrale e dal raggio.

LocationRestriction

La regione in cui cercare. Questa località funge da limitazione, il che significa che i risultati al di fuori della località indicata non verranno restituiti.

Campi

Campo unione type.

type può essere solo uno dei seguenti:
rectangle

Viewport

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

RankPreference

La modalità di classificazione dei risultati nella risposta.

Enum
RANK_PREFERENCE_UNSPECIFIED Per una query categorica come "Ristoranti a New York", il valore predefinito è RELEVANZA. Per le query non categoriche come "Mountain View, CA", ti consigliamo di lasciare rankPreference non impostato.
DISTANCE Ordina i risultati in base alla distanza.
RELEVANCE Classifica i risultati in base alla pertinenza. Ordine di ordinamento determinato dalla normale pila del ranking.

SearchAlongRouteParameters

Specifica un polilinea precalcolato dall'API Routes che definisce il percorso da cercare. La ricerca lungo un percorso è simile all'utilizzo dell'opzione di richiesta locationBias o locationRestriction per influenzare i risultati di ricerca. Tuttavia, mentre le opzioni locationBias e locationRestriction ti consentono di specificare una regione per influenzare i risultati di ricerca, questa opzione ti consente di influenzare i risultati lungo il percorso di un viaggio.

Non è garantito che i risultati si trovino lungo il percorso fornito, ma vengono classificati all'interno dell'area di ricerca definita dal polilinea e, facoltativamente, dal locationBias o dal locationRestriction in base ai tempi di deviazione minimi dall'origine alla destinazione. I risultati potrebbero essere lungo un percorso alternativo, soprattutto se il polilinea fornito non definisce un percorso ottimale dall'origine alla destinazione.

Campi
polyline

Polyline

Obbligatorio. La polilinea del percorso.

SearchTextResponse

Protocollo di risposta per SearchText.

Campi
places[]

Place

Un elenco di luoghi che soddisfano i criteri di ricerca di testo dell'utente.
routing_summaries[]

RoutingSummary

Un elenco di riepiloghi di routing in cui ogni voce è associata al luogo corrispondente nello stesso indice del campo places. Se il riepilogo del percorso non è disponibile per uno dei luoghi, conterrà una voce vuota. Se richiesto, questo elenco avrà tante voci quante quelle dell'elenco dei luoghi.
contextual_contents[]

ContextualContent

Sperimentale: per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Un elenco di contenuti contestuali in cui ogni voce è associata al luogo corrispondente nello stesso indice nel campo Luoghi. I contenuti pertinenti al text_query nella richiesta sono preferiti. Se i contenuti contestuali non sono disponibili per uno dei luoghi, verranno restituiti contenuti non contestuali. Sarà vuoto solo quando i contenuti non sono disponibili per questa località. Se richiesto, questo elenco avrà tante voci quante quelle dell'elenco dei luoghi.
next_page_token

string

Un token che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso o è vuoto, non ci sono pagine successive.
search_uri

string

Un link consente all'utente di eseguire ricerche con la stessa query di testo specificata nella richiesta su Google Maps.

TravelMode

Opzioni per la modalità di viaggio. Queste opzioni corrispondono a quelle offerte dall'API Routes.

Enum
TRAVEL_MODE_UNSPECIFIED Nessuna modalità di viaggio specificata. Il valore predefinito è DRIVE.
DRIVE Viaggiare in autovettura.
BICYCLE Viaggia in bicicletta. Non supportato con search_along_route_parameters.
WALK Viaggia a piedi. Non supportato con search_along_route_parameters.
TWO_WHEELER Veicoli a due ruote motorizzati di tutti i tipi, come scooter e motociclette. Tieni presente che questa modalità è diversa dalla modalità di viaggio BICYCLE, che riguarda i trasporti a propulsione umana. Non supportato con search_along_route_parameters. Supportato solo nei paesi elencati nella pagina Paesi e regioni supportati per i veicoli a due ruote.