Method: places.searchNearby

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 (LocationRestriction)
  },
  "rankPreference": enum (RankPreference)
}
Campi
languageCode

string

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

string

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[]

string

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[]

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 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[]

string

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[]

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 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

integer

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

object (LocationRestriction)

Obbligatorio. La regione in cui eseguire la ricerca.

rankPreference

enum (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 (Place)
    }
  ]
}
Campi
places[]

object (Place)

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 type can be only one of the following:
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
Campi

Campo unione type.

type può essere solo uno dei seguenti:

circle

object (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à.