Package google.maps.places.v1

Indice

Luoghi

Definizione del servizio per l'API Places. Nota: ogni richiesta (ad eccezione delle richieste di completamento automatico) richiede una maschera di campo impostata al di fuori del protocollo della richiesta (non viene utilizzata la variante all/*). La maschera del campo può essere impostata tramite l'intestazione HTTP X-Goog-FieldMask. Consulta: https://developers.google.com/maps/documentation/places/web-service/choose-fields

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

Restituisce previsioni per l'input specificato.
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

Ottieni una foto multimediale con una stringa di riferimento delle foto.
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}.
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

Cercare luoghi vicino a località.
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

Ricerca di luoghi basata su query di testo.

AuthorAttribution

Informazioni sull'autore dei dati generati dagli utenti. In uso in Photo e Review.

Campi
display_name

string

Nome dell'autore di Photo o Review.
uri

string

URI dell'autore di Photo o Review.
photo_uri

string

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

AutocompletePlacesRequest

Richiedi protocollo per AutocompletePlaces.

Campi
input

string

Obbligatoria. La stringa di testo in cui eseguire la ricerca.
location_bias

LocationBias

Campo facoltativo. Risultati con bias per una località specificata.

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

LocationRestriction

Campo facoltativo. Limita i risultati a una località specificata.

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

string

Campo facoltativo. Tipo di luogo principale incluso (ad esempio, "ristorante" o "gas_station") da https://developers.google.com/maps/documentation/places/web-service/place-types. Un luogo viene restituito solo se il suo tipo principale è incluso nell'elenco. È possibile specificare fino a 5 valori. Se non viene specificato alcun tipo, vengono restituiti tutti i tipi di luogo.
included_region_codes[]

string

Campo facoltativo. Includi solo i risultati nelle regioni specificate, specificate con un massimo di 15 codici regione a due caratteri CLDR. Un set vuoto non limiterà i risultati. Se location_restriction e included_region_codes sono impostati, i risultati si troveranno nell'area di intersezione.
language_code

string

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

string

Campo facoltativo. Il codice regione specificato come codice regione a due caratteri CLDR. Questo influisce sulla formattazione dell'indirizzo, sul ranking dei risultati e può influenzare i risultati restituiti. I risultati non vengono limitati alla regione specificata. Per limitare i risultati a una regione, utilizza region_code_restriction.
origin

LatLng

Campo facoltativo. Il punto di origine da cui calcolare la distanza geodetica dalla destinazione (restituito come distance_meters). Se questo valore viene omesso, la distanza geodetica non verrà restituita.
input_offset

int32

Campo facoltativo. Un offset di caratteri Unicode in base zero di input che indica la posizione del cursore in input. La posizione del cursore può influire sulle previsioni che vengono restituite.

Se vuoto, il valore predefinito è input.
include_query_predictions

bool

Campo facoltativo. Se true, la risposta includerà sia le previsioni di luogo sia quelle delle query. In caso contrario, la risposta restituirà solo previsioni Place.
session_token

string

Campo facoltativo. Una stringa che identifica una sessione di completamento automatico ai fini della fatturazione. Deve essere una stringa Base64 sicura per URL e nome file con al massimo 36 caratteri ASCII. In caso contrario, viene restituito un errore INVALID_ARGUMENT.

La sessione inizia quando l'utente inizia a digitare una query e si conclude quando seleziona un luogo e viene effettuata una chiamata a Place Details o Address Validation. Ogni sessione può includere più query, seguite da una richiesta Dettagli luogo o Convalida 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 token nuovo per ogni sessione. Se il parametro session_token viene omesso o se riutilizzi un token di sessione, la sessione viene addebitata come se non fosse stato fornito un token di sessione (ogni richiesta viene fatturata separatamente).

Consigliamo le seguenti linee guida:

  • Utilizza i token di sessione per tutte le chiamate a Place Autocomplete.
  • 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 Place Autocomplete, Place Details e Address Validation all'interno di una sessione appartengano allo stesso progetto della console Cloud.
  • 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.

LocationBias

La regione in cui cercare. I risultati potrebbero essere influenzati dalla regione specificata.

Campi

Campo di unione type.

type può essere solo uno dei seguenti:
rectangle

Viewport

Un'area visibile definita 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 verranno limitati alla regione specificata.

Campi

Campo di unione type.

type può essere solo uno dei seguenti:
rectangle

Viewport

Un'area visibile definita da un angolo nord-est e da un angolo sud-ovest.
circle

Circle

Un cerchio definito da un punto centrale e un raggio.

AutocompletePlacesResponse

Protocollo di risposta per AutocompletePlaces.

Campi
suggestions[]

Suggestion

Contiene un elenco di suggerimenti in ordine decrescente in base alla pertinenza.

Suggerimento

Risultato del suggerimento di completamento automatico.

Campi

Campo di 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 luogo o 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 i punti in cui la richiesta di input corrisponde in 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 in base a criteri diversi dalla corrispondenza delle stringhe (ad esempio, correzioni ortografiche o traslitterazioni).

Questi valori sono offset di caratteri Unicode di text. L'ordine degli intervalli è garantito in base a valori di offset crescenti.

PlacePrediction

Risultati della previsione per una previsione di Place Autocomplete.

Campi
place

string

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

string

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

FormattableText

Contiene il nome leggibile per il risultato restituito. Per i risultati relativi all'attività, di solito si tratta del nome e dell'indirizzo dell'attività.

L'app text è consigliata per gli sviluppatori che vogliono mostrare un singolo elemento UI. Gli sviluppatori che vogliono mostrare due elementi UI separati ma correlati possono usare invece structured_format. Sono due modi diversi per rappresentare una previsione di luogo. Gli utenti non devono provare ad analizzare structured_format in text e viceversa.

Questo testo potrebbe essere diverso dal display_name restituito da GetPlace.

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

StructuredFormat

Un'analisi della previsione di Place nel testo principale contenente il nome del luogo e un testo secondario contenente ulteriori elementi distintivi (come una città o una regione).

L'app structured_format è consigliata per gli sviluppatori che vogliono mostrare due elementi UI separati ma correlati. Gli sviluppatori che vogliono mostrare un singolo elemento dell'interfaccia utente potrebbero voler usare invece text. Sono due modi diversi per rappresentare una previsione di luogo. Gli utenti non devono provare ad analizzare structured_format in text e viceversa.
types[]

string

Elenco dei tipi applicabili a questo luogo dalla tabella A o dalla tabella B alla pagina https://developers.google.com/maps/documentation/places/web-service/place-types.

Un tipo è una categorizzazione 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. Alcune previsioni, come le route, potrebbero non essere compilate in questo campo.

QueryPrediction

Risultati della previsione per una previsione di completamento automatico delle 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 testuale).

L'app text è consigliata per gli sviluppatori che vogliono mostrare un singolo elemento UI. Gli sviluppatori che vogliono mostrare due elementi UI separati ma correlati possono usare invece structured_format. Esistono due modi diversi per rappresentare una previsione delle query. Gli utenti non devono provare ad analizzare structured_format in text e viceversa.

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

StructuredFormat

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

L'app structured_format è consigliata per gli sviluppatori che vogliono mostrare due elementi UI separati ma correlati. Gli sviluppatori che vogliono mostrare un singolo elemento dell'interfaccia utente potrebbero voler usare invece text. Esistono due modi diversi per rappresentare una previsione delle query. Gli utenti non devono provare ad analizzare structured_format in text e viceversa.

StringRange

Identifica una sottostringa all'interno di un determinato testo.

Campi
start_offset

int32

Offset in base zero del primo carattere Unicode della stringa (incluso).
end_offset

int32

Offset in base zero dell'ultimo carattere Unicode (escluso).

StructuredFormat

Contiene una suddivisione di un luogo o di una previsione di 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 che chiariscono la tua ambiguità (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 ulteriori elementi distintivi (ad esempio una città o una regione) per identificare ulteriormente il luogo o perfezionare la query.

A cerchio

Cerchio con LatLng come centro e raggio.

Campi
center

LatLng

Obbligatoria. Latitudine e longitudine centrali.

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

Obbligatoria. Raggio misurato in metri. Il raggio deve essere compreso tra [0,0, 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 saperne di più, 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 saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Contenuti contestuali alla query del luogo.

Campi
reviews[]

Review

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

Photo

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

Justification

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Motivazioni per il luogo.

Motivazione

Sperimentale: per saperne di più, 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 essere interessante per un utente finale.

Campi

Campo di unione justification.

justification può essere solo uno dei seguenti:
review_justification

ReviewJustification

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

BusinessAvailabilityAttributesJustification

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Motivazioni BusinessAvailabilityAttributes. Mostra alcuni attributi di un'attività che potrebbero interessare un utente finale.

Campi
takeout

bool

Se un luogo offre il servizio da asporto.
delivery

bool

Se un luogo offre la consegna a domicilio.
dine_in

bool

Se in un luogo è disponibile la consumazione sul posto.

ReviewJustification

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Motivazioni delle recensioni dell'utente. In questo modo viene evidenziata una sezione della recensione dell'utente che potrebbe interessare a un utente finale. Ad esempio, se la query di ricerca è "pizza a legna", la giustificazione della recensione evidenzia 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 dall'elemento HighlightedTextRange. Il testo potrebbe essere evidenziato in diverse parole.

Campi
text

string
highlighted_text_ranges[]

HighlightedTextRange

L'elenco degli intervalli di testo evidenziato.

HighlightedTextRange

L'intervallo di testo evidenziato.

Campi
start_index

int32
end_index

int32

EVChargeOptions

Informazioni sulla stazione di ricarica EV ospitata in loco. La terminologia segue https://afdc.energy.gov/fuels/electricity_infrastructure.html: un porto può 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 porte possono avere più connettori ma possono caricare solo un'auto alla volta (ad es.), il numero di connettori potrebbe essere maggiore del numero totale di auto che possono essere caricate contemporaneamente.
connector_aggregation[]

ConnectorAggregation

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

ConnectorAggregation

Informazioni sulla ricarica EV raggruppate per [tipo, max_charge_rate_kw]. Mostra l'aggregazione dell'addebito EV dei connettori che hanno lo stesso tipo e la tariffa di carica massima in kW.

Campi
type

EVConnectorType

Il tipo di connettore di questa aggregazione.
max_charge_rate_kw

double

La velocità di ricarica massima statica in kW di ciascun 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 attualmente disponibili in questa aggregazione.
out_of_service_count

int32

Numero di connettori in questa aggregazione che attualmente sono fuori servizio.

EVConnectorType

Consulta la pagina http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 per ulteriori informazioni/contesti sui tipi di connettori di ricarica EV.

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 tipo 2. Chiamato anche MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO di tipo CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Sistema di ricarica combinato (CA e CC). In base alla SAE. Connettore Tipo-1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 Sistema di ricarica combinato (CA e CC). 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 reale e più rappresenta la capacità di ricaricare un veicolo del marchio Tesla in 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.

FuelOptions

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

Campi
fuel_prices[]

FuelPrice

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

FuelPrice

Informazioni sul prezzo 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 Combustibile diesel.
REGULAR_UNLEADED Normale senza piombo.
MIDGRADE 89 ottani.
PREMIUM Alta qualità
SP91 PS 91
SP91_E10 SP 91 E10.
SP92 PS 92
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 PS 99
SP100 SP 100.
LPG LPG.
E80 E 80.
E85 E 85.
METHANE Metano.
BIO_DIESEL Biodiesel.
TRUCK_DIESEL Diesel per camion.

GetPhotoMediaRequest

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

Campi
name

string

Obbligatoria. Il nome della risorsa di un supporto fotografico nel formato: places/{place_id}/photos/{photo_reference}/media.

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

int32

Campo facoltativo. Specifica la larghezza massima, in pixel, dell'immagine. Se l'immagine è più piccola rispetto ai valori specificati, verrà restituita l'immagine originale. Se l'immagine è più grande in una delle due dimensioni, verrà ridimensionata in modo da corrispondere alla dimensione più piccola, limitando le proporzioni originali. Entrambe le proprietà max_height_px e max_width_px accettano un numero intero compreso tra 1 e 4800 inclusi. Se il valore non rientra nell'intervallo consentito, verrà restituito un errore INVALID_ARGUMENT.

È necessario specificare almeno un valore tra max_height_px o max_width_px. Se non viene specificato né max_height_px né max_width_px, verrà restituito un errore INVALID_ARGUMENT.
max_height_px

int32

Campo facoltativo. Specifica l'altezza massima desiderata dell'immagine, in pixel. Se l'immagine è più piccola rispetto ai valori specificati, verrà restituita l'immagine originale. Se l'immagine è più grande in una delle due dimensioni, verrà ridimensionata in modo da corrispondere alla dimensione più piccola, limitando le proporzioni originali. Entrambe le proprietà max_height_px e max_width_px accettano un numero intero compreso tra 1 e 4800 inclusi. Se il valore non rientra nell'intervallo consentito, verrà restituito un errore INVALID_ARGUMENT.

È necessario specificare almeno un valore tra max_height_px o max_width_px. Se non viene specificato né max_height_px né max_width_px, verrà restituito un errore INVALID_ARGUMENT.
skip_http_redirect

bool

Campo facoltativo. Se impostato, ignora il comportamento di reindirizzamento HTTP predefinito e visualizza una risposta in formato di testo (ad esempio, in formato JSON per il caso d'uso HTTP). Se il criterio non viene configurato, verrà eseguito un reindirizzamento HTTP per reindirizzare la chiamata al supporto 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

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

string

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

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

string

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

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

string

Campo facoltativo. Una stringa che identifica una sessione di completamento automatico ai fini della fatturazione. Deve essere una stringa Base64 sicura per URL e nome file con al massimo 36 caratteri ASCII. In caso contrario, viene restituito un errore INVALID_ARGUMENT.

La sessione inizia quando l'utente inizia a digitare una query e si conclude quando seleziona un luogo e viene effettuata una chiamata a Place Details o Address Validation. Ogni sessione può includere più query, seguite da una richiesta Dettagli luogo o Convalida 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 token nuovo per ogni sessione. Se il parametro session_token viene omesso o se riutilizzi un token di sessione, la sessione viene addebitata come se non fosse stato fornito un token di sessione (ogni richiesta viene fatturata separatamente).

Consigliamo le seguenti linee guida:

  • Utilizza i token di sessione per tutte le chiamate a Place Autocomplete.
  • 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 Place Autocomplete, Place Details e Address Validation all'interno di una sessione appartengano allo stesso progetto della console Cloud.
  • 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 di questo luogo che può essere utilizzato per cercare di nuovo la foto del luogo (detto 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.

PhotoMedia

Una foto multimediale dall'API Places.

Campi
name

string

Il nome della risorsa di un supporto fotografico nel formato: places/{place_id}/photos/{photo_reference}/media.
photo_uri

string

Un URI di breve durata che può essere utilizzato per il rendering della foto.

Posizione

Tutte le informazioni che rappresentano un luogo.

Campi
name

string

Il nome della risorsa di questo luogo, in formato places/{place_id}. Consente di 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 possibili valori, consulta la tabella A e la tabella 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", "caffetteria", "aeroporto" e così via. Un luogo può avere un solo tipo principale. Per l'elenco completo dei possibili valori, consulta la tabella A e la tabella 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 possibili valori, consulta la tabella A e la tabella B all'indirizzo https://developers.google.com/maps/documentation/places/web-service/place-types
national_phone_number

string

Un numero di telefono leggibile del luogo in formato nazionale.
international_phone_number

string

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

string

Un indirizzo completo leggibile di questo luogo.
short_formatted_address

string

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

AddressComponent

Componenti ripetuti per ogni livello di località. Nota le seguenti informazioni sull'array address_components[]: - L'array di componenti indirizzo può contenere più componenti di formatted_address. - 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 lo stesso tra le richieste. In particolare, il numero di address_components varia in base all'indirizzo richiesto e può cambiare nel tempo per lo stesso indirizzo. Un componente può cambiare la posizione nell'array. Il tipo di componente può cambiare. In una risposta successiva potrebbe mancare un componente specifico.
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 a mostrare il luogo su una mappa di dimensioni medie.
rating

double

Una valutazione compresa tra 1 e 5, 0 basata sulle 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 del 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), di solito si tratta del sito web del singolo negozio, non dell'intera catena.
reviews[]

Review

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

OpeningHours

I normali orari di apertura.
photos[]

Photo

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

string

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

BusinessStatus

Lo stato dell'attività per il luogo.
price_level

PriceLevel

Livello dei prezzi del luogo.
attributions[]

Attribution

Un insieme di fornitori di dati che deve essere mostrato con questo risultato.
icon_mask_base_uri

string

Un URL troncato a una maschera di icona. L'utente può accedere a un tipo di icona diverso 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

Gli orari di apertura per i prossimi sette giorni (incluso oggi). Il periodo di tempo inizia a mezzanotte del giorno della richiesta e termina alle 23:59 di sei giorni dopo. Questo campo include il campo secondario special_days di tutti gli orari, impostato per date con orari eccezionali.
current_secondary_opening_hours[]

OpeningHours

Contiene un array di voci per i sette giorni successivi, comprese le informazioni sugli orari secondari di un'attività. Gli orari secondari sono diversi da quelli principali dell'attività. Ad esempio, un ristorante può specificare come orario secondario l'orario del drive-through o l'orario di consegna. Questo campo compila il sottocampo del tipo, che viene ricavato da un elenco predefinito dei tipi di orari di apertura (ad esempio Drive_THROUGH, PICKUP o TAKEOUT) in base alla tipologia di luogo. Questo campo include il campo secondario special_days di tutti gli orari, impostato per date con orari eccezionali.
regular_secondary_opening_hours[]

OpeningHours

Contiene un array di voci relative a informazioni sui normali orari secondari di un'attività. Gli orari secondari sono diversi da quelli principali dell'attività. Ad esempio, un ristorante può specificare come orario secondario l'orario del drive-through o l'orario di consegna. Questo campo compila il sottocampo del tipo, che viene ricavato da un elenco predefinito dei tipi di orari di apertura (ad esempio Drive_THROUGH, PICKUP o TAKEOUT) in base alla tipologia di luogo.
editorial_summary

LocalizedText

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

PaymentOptions

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

ParkingOptions

Opzioni di parcheggio offerte dal luogo.
sub_destinations[]

SubDestination

Un elenco di destinazioni secondarie correlate a questo luogo.
fuel_options

FuelOptions

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

EVChargeOptions

Informazioni sulle opzioni di ricarica ev.
generative_summary

GenerativeSummary

Sperimentale: per saperne di più, 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 saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

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

int32

Numero di minuti in cui il fuso orario di questo luogo è attualmente diverso da UTC. Questo valore è espresso in minuti per supportare i fusi orari compensati da frazioni di 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'asporto.
delivery

bool

Specifica se l'attività supporta la consegna.
dine_in

bool

Specifica se l'attività supporta tavoli all'interno o all'esterno.
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 questo 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 ristorante serve cibo vegetariano.
outdoor_seating

bool

Questo locale dispone di tavoli all'aperto.
live_music

bool

Questo luogo offre musica dal vivo.
menu_for_children

bool

Locale con menu per bambini.
serves_cocktails

bool

Locale che serve cocktail.
serves_dessert

bool

Locale che serve dessert.
serves_coffee

bool

Questo posto serve caffè.
good_for_children

bool

Luogo adatto ai bambini.
allows_dogs

bool

In questo luogo sono ammessi i cani.
restroom

bool

Questa struttura dispone di bagno.
good_for_groups

bool

Questo luogo può ospitare gruppi.
good_for_watching_sports

bool

Luogo adatto per guardare sport.
accessibility_options

AccessibilityOptions

Informazioni sulle opzioni di accessibilità offerte da un luogo.

AccessibilityOptions

Informazioni sulle opzioni di accessibilità offerte da un luogo.

Campi
wheelchair_accessible_parking

bool

Questo luogo offre un parcheggio accessibile in sedia a rotelle.
wheelchair_accessible_entrance

bool

Places dispone di ingresso accessibile in sedia a rotelle.
wheelchair_accessible_restroom

bool

Questa struttura dispone di bagno accessibile in sedia a rotelle.
wheelchair_accessible_seating

bool

Questa struttura dispone di tavoli accessibili in sedia a rotelle.

AddressComponent

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

Campi
long_text

string

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

string

Un array che indica i tipi del componente indirizzo.
language_code

string

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

AreaSummary

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

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

Campi
content_blocks[]

ContentBlock

Blocchi di contenuti che compongono il riepilogo dell'area. Ogni blocco ha un argomento distinto sull'area.

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 di Place.

BusinessStatus

Stato dell'attività del luogo.

Enum
BUSINESS_STATUS_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
OPERATIONAL La struttura è operativa, non necessariamente aperta al momento.
CLOSED_TEMPORARILY La struttura è chiusa temporaneamente.
CLOSED_PERMANENTLY La struttura è chiusa definitivamente.

GenerativeSummary

Sperimentale: per saperne di più, 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.
description

LocalizedText

La descrizione dettagliata del luogo.
references

References

Riferimenti utilizzati per generare la descrizione riepilogativa.

OpeningHours

Informazioni sull'orario di apertura del luogo.

Campi
periods[]

Period

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

string

Stringhe localizzate che descrivono gli orari di apertura di questo luogo, una stringa per ogni giorno della settimana. Il campo sarà vuoto se l'orario non è noto o se non è 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 orario secondario.
special_days[]

SpecialDay

Informazioni strutturate per giorni speciali che rientrano nel periodo coperto dall'orario di apertura restituito. I giorni speciali sono quelli che potrebbero influire sull'orario di apertura di un luogo, ad esempio il giorno di Natale. Impostalo per current_opening_hours e current_secondary_opening_hours in caso di orari eccezionali.
open_now

bool

Questo luogo è aperto adesso? Sempre presente, a meno che non ci siano dati relativi all'ora del giorno o al fuso orario di questi orari di apertura.

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 che cambiano 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 nei tempi in cui siamo disposti a restituire ore, quindi tronchiamo le ore tornando a questi limiti. In questo modo, verranno restituite al massimo 24 * 7 ore dalla mezzanotte del giorno della richiesta.
day

int32

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

int32

L'ora in due cifre. L'intervallo è compreso tra 00 e 23.
minute

int32

Il minuto in due cifre. L'intervallo è compreso tra 00 e 59.

SecondaryHoursType

Tipo utilizzato per identificare il tipo di orario secondario.

Enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Valore predefinito se il tipo di ora secondario non è specificato.
DRIVE_THROUGH L'ora drive-through di banche, ristoranti o farmacie.
HAPPY_HOUR L'happy hour.
DELIVERY L'ora di consegna.
TAKEOUT L'ora di asporto.
KITCHEN L'ora della cucina.
BREAKFAST L'ora della colazione.
LUNCH L'ora di pranzo.
DINNER È ora di cena.
BRUNCH È l'ora del brunch.
PICKUP L'ora di ritiro.
ACCESS Le ore di accesso alle posizioni di archiviazione.
SENIOR_HOURS Orari speciali per gli anziani.
ONLINE_SERVICE_HOURS Gli orari di servizio online.

SpecialDay

Informazioni strutturate per giorni speciali che rientrano nel periodo coperto dall'orario di apertura restituito. I giorni speciali sono quelli 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 può supportare più opzioni contemporaneamente.

Campi
free_parking_lot

bool

Questo hotel dispone di parcheggi gratuiti.
paid_parking_lot

bool

Questo luogo offre parcheggi a pagamento.
free_street_parking

bool

Il parcheggio in strada è incluso nel prezzo.
paid_street_parking

bool

Questo luogo offre parcheggio in strada a pagamento.
valet_parking

bool

Offre anche il servizio di parcheggio.
free_garage_parking

bool

Offre anche il parcheggio in garage incluso nel prezzo.
paid_garage_parking

bool

Questo luogo offre il parcheggio in garage a pagamento.

PaymentOptions

Opzioni di pagamento accettate dal luogo.

Campi
accepts_credit_cards

bool

Questo luogo accetta le carte di credito come metodo di pagamento.
accepts_debit_cards

bool

Questo luogo accetta le carte di debito come pagamento.
accepts_cash_only

bool

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

bool

Place accetta pagamenti NFC.

PlusCode

Il Plus Code (http://plus.codes) è un riferimento di località con due formati: codice globale che definisce un rettangolo di 14 x 14 m (1/8000 di grado) e un 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 di 1/8000 gradi (~14 x 14 metri).
compound_code

string

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

Inserisci il nome e l'ID della risorsa delle destinazioni secondarie correlate al luogo. Ad esempio, terminal diversi sono destinazioni diverse di un aeroporto.

Campi
name

string

Il nome della risorsa della destinazione secondaria.
id

string

L'ID luogo della destinazione secondaria.

PriceLevel

Livello dei prezzi del luogo.

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

Riferimenti

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Riferimenti a cui sono correlati i contenuti generativi.

Campi
reviews[]

Review

Recensioni che fungono da riferimenti.
places[]

string

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

Riepilogo

Informazioni sulla recensione di un luogo.

Campi
name

string

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

string

Una stringa formattata con l'ora recente, che esprime la data e l'ora della revisione relative all'ora corrente in un formato appropriato 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 revisione.

SearchNearbyRequest

Richiedi protocollo per 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 restituire i dettagli sul luogo di qualsiasi lingua, con una preferenza per l'inglese, se tali dettagli sono presenti.

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

string

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

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

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

string

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

È possibile specificare fino a 50 tipi nella Tabella A.

Se ci sono tipi in conflitto, ad esempio un tipo compare sia in inclusion_types ed escluse_type, viene restituito un errore INVALID_ARGUMENT.

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

string

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

È possibile specificare fino a 50 tipi nella Tabella A.

Se il cliente fornisce entrambi i valori inclusi (ad es. ristorante) ed esclusi (ad es. bar), la risposta deve includere luoghi che sono un ristorante, ma non un bar. La risposta include i luoghi che corrispondono ad almeno uno dei valori inclusi e nessuno dei tipi esclusi.

Se ci sono tipi in conflitto, ad esempio un tipo compare sia in inclusion_types ed escluse_type, viene restituito un errore INVALID_ARGUMENT.

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

string

Tipo di luogo principale incluso (ad es. "ristorante" o "gas_station") 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 nella Tabella A.

Se sono presenti tipi primari in conflitto, ovvero un tipo compare sia in inclusion_primary_types ed escluse_primary_types, viene restituito un errore INVALID_ARGUMENT.

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

string

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

È possibile specificare fino a 50 tipi nella Tabella A.

Se sono presenti tipi primari in conflitto, ovvero un tipo compare sia in inclusion_primary_types ed escluse_primary_types, viene restituito un errore INVALID_ARGUMENT.

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

int32

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

LocationRestriction

Obbligatoria. La regione in cui cercare.
rank_preference

RankPreference

Come verranno classificati i risultati nella risposta.

LocationRestriction

La regione in cui cercare.

Campi

Campo di unione type.

type può essere solo uno dei seguenti:
circle

Circle

Un cerchio definito dal punto centrale e dal raggio.

RankPreference

Come verranno classificati i risultati nella risposta.

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

SearchNearbyResponse

Protocollo di risposta per Ricerca nelle vicinanze.

Campi
places[]

Place

Un elenco di luoghi che soddisfano i requisiti degli utenti, ad esempio tipi di luoghi, numero di luoghi e limitazioni specifiche per le località.

SearchTextRequest

Richiedi protocollo per SearchText.

Campi
text_query

string

Obbligatoria. La query di testo per la ricerca testuale.
language_code

string

I dettagli del luogo verranno visualizzati nella lingua preferita, se disponibile. Se il codice lingua non è specificato o non è riconosciuto, è possibile restituire i dettagli sul luogo di qualsiasi lingua, con una preferenza per l'inglese, se tali dettagli sono presenti.

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

string

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

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

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

RankPreference

Come verranno classificati i 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. È supportato 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 è strettamente inferiore a questo limite. Un valore valido deve essere un numero in virgola mobile compreso tra 0 e 5 (inclusi) a una cadenza di 0,5, ovvero [0, 0,5, 1,0, ..., 5,0] inclusi. La valutazione dell'input verrà arrotondata per eccesso allo 0,5(max) più vicino. Ad esempio, una valutazione pari a 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 che è possibile restituire per pagina. Se il numero di risultati disponibili è superiore a max_result_count, viene restituito un next_page_token che può essere trasmesso a page_token per ottenere la pagina successiva dei risultati nelle richieste successive. Se viene fornito un valore pari a 0 o nessun valore, viene utilizzato il valore predefinito 20. Il valore massimo è 20; i valori superiori a 20 verranno forzati a 20. I valori negativi restituiranno un errore INVALID_ARGUMENT.

Se max_result_count e page_size sono specificati, max_result_count verrà ignorato.
page_size

int32

Campo facoltativo. Il numero massimo di risultati che è possibile restituire per pagina. Se il numero di risultati disponibili è superiore a page_size, viene restituito un next_page_token che può essere trasmesso a page_token per ottenere la pagina successiva dei risultati nelle richieste successive. Se viene fornito un valore pari a 0 o nessun valore, viene utilizzato il valore predefinito 20. Il valore massimo è 20; i valori superiori a 20 verranno impostati su 20. I valori negativi restituiranno un errore INVALID_ARGUMENT.

Se max_result_count e page_size sono specificati, max_result_count verrà ignorato.
page_token

string

Campo facoltativo. Un token di pagina, ricevuto da una precedente chiamata TextSearch. Specifica questo valore per recuperare la pagina successiva.

Durante l'impaginazione, 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 della pagina. In caso contrario, viene restituito un errore INVALID_ARGUMENT.
price_levels[]

PriceLevel

Utilizzato per limitare la ricerca ai luoghi contrassegnati come 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 perincluded_type. Se impostato su true, verranno restituiti solo i 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 i risultati relativi a una determinata località. Non può essere impostato insieme a location_restriction.
location_restriction

LocationRestriction

La regione in cui cercare. Questa località è una limitazione, il che significa che i risultati al di fuori della località non verranno restituiti. Non possono essere impostati insieme a location_bias.
ev_options

EVOptions

Campo facoltativo. Imposta le opzioni EV disponibili per la ricerca di una richiesta di ricerca di luoghi.

EVOptions

Opzioni EV ricercabili di una richiesta di ricerca di luoghi.

Campi
minimum_charging_rate_kw

double

Campo facoltativo. Velocità di ricarica minima richiesta in kilowatt. Un luogo con una tariffa di addebito inferiore a quella specificata viene filtrato.
connector_types[]

EVConnectorType

Campo facoltativo. L'elenco dei tipi di connettori EV preferiti. Una posizione che non supporta nessuno dei tipi di connettore elencati viene filtrata ed esclusa.

LocationBias

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

Campi

Campo di unione type.

type può essere solo uno dei seguenti:
rectangle

Viewport

Un riquadro rettangolare definito dall'angolo nord-est e sud-ovest. rectangle.high() deve essere il punto a nord-est dell'area visibile rettangolare. rectangle.low() deve essere il punto a sud-ovest dell'area visibile del rettangolo. rectangle.low().latitude() non può essere superiore a rectangle.high().latitude(). In questo modo l'intervallo di latitudine visualizzato sarà vuoto. L'area visibile rettangolare 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à è una limitazione, il che significa che i risultati al di fuori della località non verranno restituiti.

Campi

Campo di unione type.

type può essere solo uno dei seguenti:
rectangle

Viewport

Un riquadro rettangolare definito dall'angolo nord-est e sud-ovest. rectangle.high() deve essere il punto a nord-est dell'area visibile rettangolare. rectangle.low() deve essere il punto a sud-ovest dell'area visibile del rettangolo. rectangle.low().latitude() non può essere superiore a rectangle.high().latitude(). In questo modo l'intervallo di latitudine visualizzato sarà vuoto. L'area visibile rettangolare non può essere più larga di 180 gradi.

RankPreference

Come verranno classificati i risultati nella risposta.

Enum
RANK_PREFERENCE_UNSPECIFIED Per una query di categoria, come "Ristoranti a New York", RELEVANCE è l'impostazione predefinita. Per le query non categoriche, ad esempio "Mountain View, CA", consigliamo di non impostare rankingPreference.
DISTANCE Classifica i risultati in base alla distanza.
RELEVANCE Classifica i risultati in base alla pertinenza. Ordinamento determinato dal normale stack di ranking.

SearchTextResponse

Protocollo di risposta per SearchText.

Campi
places[]

Place

Un elenco di luoghi che soddisfano i criteri di ricerca testuale dell'utente.
contextual_contents[]

ContextualContent

Sperimentale: per saperne di più, 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 alla posizione corrispondente nello stesso indice nel campo Places. I contenuti pertinenti a text_query nella richiesta sono preferiti. Se i contenuti contestuali non sono disponibili per uno dei luoghi, verranno restituiti contenuti non contestuali. Il campo sarà vuoto solo quando i contenuti non saranno disponibili per questo luogo. Questo elenco deve contenere tante voci quante sono le voci dell'elenco di luoghi, se richiesto.
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 saranno pagine successive.