Cerca luoghi vicino alle località.
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 nella lingua preferita, se disponibile. Se il codice della lingua non è specificato o non è riconosciuto, è possibile restituire i dettagli relativi a qualsiasi lingua, con una preferenza per l'inglese, se tali dettagli esistono. Elenco aggiornato delle lingue supportate: https://developers.google.com/maps/faq#languagesupport. |
regionCode |
Il codice Unicode paese/regione (CLDR) della località da cui proviene la richiesta. Questo parametro viene utilizzato per visualizzare i dettagli del luogo, come il nome del luogo specifico della 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 3 cifre non sono attualmente supportati. |
includedTypes[] |
Tipo di luogo incluso (ad esempio "ristorante" o "gas_station") da https://developers.google.com/maps/documentation/places/web-service/place-types. È possibile specificare fino a 50 tipi dalla Tabella A. Se sono presenti tipi in conflitto, ad es. un tipo viene visualizzato sia in includedTypes ed excludedTypes, viene restituito un errore INVALID_ completo. Se un tipo di luogo è specificato con più limitazioni per tipo, vengono restituiti solo i luoghi che soddisfano tutte le restrizioni. Ad esempio, se abbiamo {includedTypes = ["ristorante"], excludedprimaryTypes = ["ristorante"]}, i luoghi restituiti forniscono servizi correlati ai "ristoranti" ma non operano principalmente come "ristoranti". |
excludedTypes[] |
Tipo di luogo escluso (ad esempio "ristorante" o "gas_station") da https://developers.google.com/maps/documentation/places/web-service/place-types. È possibile specificare fino a 50 tipi dalla Tabella A. Se il cliente fornisce sia includedTypes (ad es. ristorante) sia excludedTypes (ad es. bar), la risposta deve includere luoghi che sono ristoranti, ma non bar. La risposta include posizioni che corrispondono ad almeno uno degli inclusiType e a nessuno di excludedTypes. Se sono presenti tipi in conflitto, ad es. un tipo viene visualizzato sia in includedTypes ed excludedTypes, viene restituito un errore INVALID_ completo. Se un tipo di luogo è specificato con più limitazioni per tipo, vengono restituiti solo i luoghi che soddisfano tutte le restrizioni. Ad esempio, se abbiamo {includedTypes = ["ristorante"], excludedprimaryTypes = ["ristorante"]}, i luoghi restituiti forniscono servizi correlati ai "ristoranti" ma non operano principalmente come "ristoranti". |
includedPrimaryTypes[] |
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 dalla Tabella A. Se sono presenti tipi primari in conflitto, ad esempio un tipo viene visualizzato sia in includedprimaryTypes sia in excludedprimaryTypes, viene restituito un errore INVALID_ARGUMENT. Se un tipo di luogo è specificato con più limitazioni per tipo, vengono restituiti solo i luoghi che soddisfano tutte le restrizioni. Ad esempio, se abbiamo {includedTypes = ["ristorante"], excludedprimaryTypes = ["ristorante"]}, i luoghi restituiti forniscono servizi correlati ai "ristoranti" ma non operano principalmente come "ristoranti". |
excludedPrimaryTypes[] |
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 dalla Tabella A. Se sono presenti tipi primari in conflitto, ad esempio un tipo viene visualizzato sia in includedprimaryTypes sia in excludedprimaryTypes, viene restituito un errore INVALID_ARGUMENT. Se un tipo di luogo è specificato con più limitazioni per tipo, vengono restituiti solo i luoghi che soddisfano tutte le restrizioni. Ad esempio, se abbiamo {includedTypes = ["ristorante"], excludedprimaryTypes = ["ristorante"]}, i luoghi restituiti forniscono servizi correlati ai "ristoranti" ma non operano principalmente come "ristoranti". |
maxResultCount |
Numero massimo di risultati da restituire. Deve essere compreso tra 1 e 20 (valore predefinito). Se il numero non viene impostato, viene raggiunto il limite massimo. 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 degli utenti, ad esempio 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 di unione
|
|
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 per POPULARITY. |
DISTANCE |
Ordina i risultati in base alla distanza. |
POPULARITY |
Ordina i risultati in base alla popolarità. |