Method: places.searchNearby

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

string

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

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

string

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

string

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

string

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

string

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

integer

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

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

Campo di unione type.

type può essere solo uno dei seguenti:

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