Method: places.searchNearby

Cercare luoghi vicino a posizioni.

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)
  },
  "includeFutureOpeningBusinesses": boolean
}
Campi
languageCode

string

I dettagli del luogo verranno visualizzati nella lingua preferita, se disponibile. Se il codice della lingua non è specificato o non è riconosciuto, potrebbero essere restituiti i dettagli di qualsiasi lingua del luogo, 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, 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, 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 "stazione di servizio") 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, ovvero un tipo viene visualizzato sia in includedTypes che in excludedTypes, viene restituito un errore INVALID_ARGUMENT.

Se viene specificato un tipo di luogo con 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 "stazione di servizio") da https://developers.google.com/maps/documentation/places/web-service/place-types.

È possibile specificare fino a 50 tipi dalla Tabella A.

Se il client fornisce sia includedTypes (ad es. ristorante) sia excludedTypes (ad es. bar), la risposta deve includere i luoghi che sono ristoranti ma non bar. La risposta include luoghi che corrispondono ad almeno uno degli includedTypes e a nessuno degli excludedTypes.

Se sono presenti tipi in conflitto, ovvero un tipo viene visualizzato sia in includedTypes che in excludedTypes, viene restituito un errore INVALID_ARGUMENT.

Se viene specificato un tipo di luogo con 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 tra quelli riportati nella tabella dei tipi supportati.

È possibile specificare fino a 50 tipi dalla Tabella A.

Se sono presenti tipi primari in conflitto, ovvero un tipo viene visualizzato sia in includedPrimaryTypes che in excludedPrimaryTypes, viene restituito un errore INVALID_ARGUMENT.

Se viene specificato un tipo di luogo con 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 dalla Tabella A.

Se sono presenti tipi primari in conflitto, ovvero un tipo viene visualizzato sia in includedPrimaryTypes che in excludedPrimaryTypes, viene restituito un errore INVALID_ARGUMENT.

Se viene specificato un tipo di luogo con 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 eseguire la ricerca.
rankPreference

enum (RankPreference)

Come verranno classificati i risultati nella risposta.
routingParameters

object (RoutingParameters)

Facoltativo. Parametri che influiscono sul routing ai risultati di ricerca.
includeFutureOpeningBusinesses

boolean

Facoltativo. Se è vero, includi le attività che non sono ancora aperte, ma lo saranno in futuro.

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 limitazione di località specifica.
routingSummaries[]

object (RoutingSummary)

Un elenco di riepiloghi degli itinerari in cui ogni voce è associata al luogo corrispondente nello stesso indice del campo places. Se il riepilogo dell'itinerario non è disponibile per uno dei luoghi, conterrà una voce vuota. Se richiesto, questo elenco deve contenere lo stesso numero di voci dell'elenco dei luoghi.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

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 tipi:
circle

object (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 POPOLARITÀ.
DISTANCE Ordina i risultati in base alla distanza.
POPULARITY Classifica i risultati in base alla popolarità.