Cercare luoghi nelle vicinanze.
Richiesta HTTP
POST https://places.googleapis.com/v1/places:searchNearby
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "languageCode": string, "regionCode": string, "includedTypes": [ string ], "excludedTypes": [ string ], "includedPrimaryTypes": [ string ], "excludedPrimaryTypes": [ string ], "maxResultCount": integer, "locationRestriction": { object ( |
Campi | |
---|---|
languageCode |
I dettagli del luogo verranno visualizzati con la lingua preferita, se disponibile. Se il codice lingua non è specificato o non viene riconosciuto, potrebbero essere restituiti i dettagli relativi a qualsiasi lingua, con una preferenza per l'inglese, se presenti. Elenco aggiornato delle lingue supportate: https://developers.google.com/maps/faq#languagesupport. |
regionCode |
Il codice Unicode del paese/della 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 regione, se disponibile. Il parametro può influire sui risultati in base alla legge vigente. Per ulteriori informazioni, visita il sito 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. |
includedTypes[] |
Tipo di luogo incluso (ad es. "ristorante" o "stazioni di servizio") in 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, ad esempio se un tipo viene visualizzato sia inincludedTypes che in excludedTypes, viene restituito un errore INVALID_ARGUMENT. Se un tipo di luogo viene specificato con più limitazioni di tipo, vengono restituiti solo i luoghi che soddisfano tutte le limitazioni. Ad esempio, se abbiamo {includedTypes = ["ristorante"], excludedprimaryTypes = ["ristorante"]}, i luoghi restituiti forniscono "ristorante" ma non operano principalmente come "ristoranti". |
excludedTypes[] |
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 inclusionTypes (ad es. ristorante) sia excludedTypes (ad es. bar), la risposta dovrebbe includere luoghi che sono ristoranti ma non bar. La risposta include posizioni che corrispondono ad almeno uno degli elementi inclusiType e a nessuno degli esclusi. Se sono presenti tipi in conflitto, ad esempio se un tipo viene visualizzato sia inincludedTypes che in excludedTypes, viene restituito un errore INVALID_ARGUMENT. Se un tipo di luogo viene specificato con più limitazioni di tipo, vengono restituiti solo i luoghi che soddisfano tutte le limitazioni. Ad esempio, se abbiamo {includedTypes = ["ristorante"], excludedprimaryTypes = ["ristorante"]}, i luoghi restituiti forniscono "ristorante" ma non operano principalmente come "ristoranti". |
includedPrimaryTypes[] |
Tipo di luogo principale incluso (ad es. "ristorante" o "gas_station") di https://developers.google.com/maps/documentation/places/web-service/place-types. A un luogo può essere associato un solo tipo principale della tabella dei tipi supportati. È possibile specificare fino a 50 tipi della Tabella A. Se sono presenti tipi primari in conflitto, ad esempio se un tipo è presente sia in inclusionprimaryTypes che in excludedprimaryTypes, viene restituito un errore INVALID_ARGUMENT. Se un tipo di luogo viene specificato con più limitazioni di tipo, vengono restituiti solo i luoghi che soddisfano tutte le limitazioni. Ad esempio, se abbiamo {includedTypes = ["ristorante"], excludedprimaryTypes = ["ristorante"]}, i luoghi restituiti forniscono "ristorante" ma non operano principalmente come "ristoranti". |
excludedPrimaryTypes[] |
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 primari in conflitto, ad esempio se un tipo è presente sia in inclusionprimaryTypes che in excludedprimaryTypes, viene restituito un errore INVALID_ARGUMENT. Se un tipo di luogo viene specificato con più limitazioni di tipo, vengono restituiti solo i luoghi che soddisfano tutte le limitazioni. Ad esempio, se abbiamo {includedTypes = ["ristorante"], excludedprimaryTypes = ["ristorante"]}, i luoghi restituiti forniscono "ristorante" ma non operano principalmente come "ristoranti". |
maxResultCount |
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 superiore. Se il numero è impostato su negativo o supera il limite superiore, viene restituito un errore INVALID_ARGUMENT. |
locationRestriction |
Obbligatorio. La regione in cui eseguire la ricerca. |
rankPreference |
Come verranno classificati i risultati nella risposta. |
Corpo della risposta
Protocollo di risposta per Ricerca nelle vicinanze.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"places": [
{
object ( |
Campi | |
---|---|
places[] |
Un elenco di luoghi che soddisfano i requisiti dell'utente, come tipi di luoghi, numero di luoghi e limitazioni di località specifiche. |
LocationRestriction
La regione in cui eseguire la ricerca.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
|
|
circle |
Un cerchio definito dal centro e dal raggio. |
RankPreference
Come verranno classificati i risultati nella risposta.
Enum | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
Valore di RankPreference non impostato. Per impostazione predefinita, verrà utilizzato il ranking per POPULARITY. |
DISTANCE |
Classifica i risultati in base alla distanza. |
POPULARITY |
Classifica i risultati in base alla popolarità. |