Method: places.searchNearby

Cerca luoghi nelle vicinanze di una 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 (LocationRestriction)
  },
  "rankPreference": enum (RankPreference),
  "routingParameters": {
    object (RoutingParameters)
  }
}
Campi
languageCode

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

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

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 includedTypes che in excludedTypes, 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 {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}, i luoghi restituiti forniscono servizi correlati ai "ristoranti", 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 cliente fornisce sia includedTypes (ad es. ristorante) che excludedTypes (ad es. bar), la risposta deve includere i luoghi che sono ristoranti, ma non bar. La risposta include i luoghi corrispondenti ad almeno uno dei tipi inclusi e a nessuno dei tipi esclusi.

Se sono presenti tipi in conflitto, ovvero un tipo compare sia in includedTypes che in excludedTypes, 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 {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}, i luoghi restituiti forniscono servizi correlati ai "ristoranti", ma non operano principalmente come "ristoranti".
includedPrimaryTypes[]

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 includedPrimaryTypes che in excludedPrimaryTypes, 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 {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}, i luoghi restituiti forniscono servizi correlati ai "ristoranti", 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 principali in conflitto, ovvero un tipo compare sia in includedPrimaryTypes che in excludedPrimaryTypes, 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 {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}, i luoghi restituiti forniscono servizi correlati ai "ristoranti", ma non operano principalmente come "ristoranti".
maxResultCount

integer

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

object (LocationRestriction)

Obbligatorio. La regione in cui cercare.
rankPreference

enum (RankPreference)

La modalità di classificazione dei risultati nella risposta.
routingParameters

object (RoutingParameters)

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

Corpo della risposta

Proto di risposta per la ricerca nelle vicinanze.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "places": [
    {
      object (Place)
    }
  ],
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
  ]
}
Campi
places[]

object (Place)

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

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

LocationRestriction

La regione in cui cercare.

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