Method: places.searchText

Ricerca di luoghi basata su query di testo.

Richiesta HTTP

POST https://places.googleapis.com/v1/places:searchText

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "rankPreference": enum (RankPreference),
  "includedType": string,
  "openNow": boolean,
  "minRating": number,
  "maxResultCount": integer,
  "priceLevels": [
    enum (PriceLevel)
  ],
  "strictTypeFiltering": boolean,
  "locationBias": {
    object (LocationBias)
  },
  "locationRestriction": {
    object (LocationRestriction)
  },
  "evOptions": {
    object (EVOptions)
  }
}
Campi
textQuery

string

Obbligatoria. La query di testo per la ricerca testuale.
languageCode

string

I dettagli del luogo verranno visualizzati nella lingua preferita, se disponibile. Se il codice lingua non è specificato o non è riconosciuto, è possibile restituire i dettagli sul luogo di qualsiasi lingua, con una preferenza per l'inglese, se tali dettagli sono presenti.

Elenco aggiornato delle lingue supportate: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Il codice paese/regione Unicode (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, vedi 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.
rankPreference

enum (RankPreference)

Come verranno classificati i risultati nella risposta.
includedType

string

Il tipo di luogo richiesto. Elenco completo dei tipi supportati: https://developers.google.com/maps/documentation/places/web-service/place-types. È supportato solo un tipo incluso.
openNow

boolean

Utilizzato per limitare la ricerca ai luoghi attualmente aperti. Il valore predefinito è false.
minRating

number

Filtra i risultati la cui valutazione media degli utenti è strettamente inferiore a questo limite. Un valore valido deve essere un numero in virgola mobile compreso tra 0 e 5 (inclusi) a una cadenza di 0,5, ovvero [0, 0,5, 1,0, ..., 5,0] inclusi. La valutazione dell'input verrà arrotondata per eccesso allo 0,5(max) più vicino. Ad esempio, una valutazione pari a 0,6 eliminerà tutti i risultati con una valutazione inferiore a 1,0.
maxResultCount

integer

Numero massimo di risultati da restituire. Il valore deve essere compreso tra 1 e 20 inclusi. Il valore predefinito è 20. Se il numero non viene impostato, torna al limite massimo. Se il numero è impostato su negativo o supera il limite superiore, viene restituito un errore INVALID_ARGUMENT.
priceLevels[]

enum (PriceLevel)

Utilizzato per limitare la ricerca ai luoghi contrassegnati come determinati livelli di prezzo. Gli utenti possono scegliere qualsiasi combinazione di livelli di prezzo. Per impostazione predefinita, vengono selezionati tutti i livelli di prezzo.
strictTypeFiltering

boolean

Utilizzato per impostare il filtro del tipo rigoroso perincludedType. Se impostato su true, verranno restituiti solo i risultati dello stesso tipo. Il valore predefinito è false.
locationBias

object (LocationBias)

La regione in cui cercare. Questa località funge da bias, il che significa che potrebbero essere restituiti i risultati relativi a una determinata località. Non possono essere impostati insieme a locationRestriction.
locationRestriction

object (LocationRestriction)

La regione in cui cercare. Questa località è una limitazione, il che significa che i risultati al di fuori della località non verranno restituiti. Non possono essere impostati insieme a locationBias.
evOptions

object (EVOptions)

Campo facoltativo. Imposta le opzioni EV disponibili per la ricerca di una richiesta di ricerca di luoghi.

Corpo della risposta

Protocollo di risposta per places.searchText.

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 criteri di ricerca testuale dell'utente.

RankPreference

Come verranno classificati i risultati nella risposta.

Enum
RANK_PREFERENCE_UNSPECIFIED Per una query di categoria, come "Ristoranti a New York", RELEVANCE è l'impostazione predefinita. Per le query non categoriche, ad esempio "Mountain View, CA", consigliamo di non impostare rankingPreference.
DISTANCE Classifica i risultati in base alla distanza.
RELEVANCE Classifica i risultati in base alla pertinenza. Ordinamento determinato dal normale stack di ranking.

LocationBias

La regione in cui cercare. Questa località funge da bias, il che significa che potrebbero essere restituiti i risultati relativi a una determinata località.

Rappresentazione JSON 
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "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:
rectangle

object (Viewport)

Un riquadro rettangolare definito dall'angolo nord-est e sud-ovest. rectangle.high() deve essere il punto a nord-est dell'area visibile rettangolare. rectangle.low() deve essere il punto a sud-ovest dell'area visibile del rettangolo. rectangle.low().latitude() non può essere superiore a rectangle.high().latitude(). In questo modo l'intervallo di latitudine visualizzato sarà vuoto. L'area visibile rettangolare non può essere più larga di 180 gradi.
circle

object (Circle)

Un cerchio definito dal punto centrale e dal raggio.

LocationRestriction

La regione in cui cercare. Questa località è una limitazione, il che significa che i risultati al di fuori della località non verranno restituiti.

Rappresentazione JSON 
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
Campi

Campo di unione type.

type può essere solo uno dei seguenti:
rectangle

object (Viewport)

Un riquadro rettangolare definito dall'angolo nord-est e sud-ovest. rectangle.high() deve essere il punto a nord-est dell'area visibile rettangolare. rectangle.low() deve essere il punto a sud-ovest dell'area visibile del rettangolo. rectangle.low().latitude() non può essere superiore a rectangle.high().latitude(). In questo modo l'intervallo di latitudine visualizzato sarà vuoto. L'area visibile rettangolare non può essere più larga di 180 gradi.

EVOptions

Opzioni EV ricercabili di una richiesta di ricerca di luoghi.

Rappresentazione JSON 
{
  "minimumChargingRateKw": number,
  "connectorTypes": [
    enum (EVConnectorType)
  ]
}
Campi
minimumChargingRateKw

number

Campo facoltativo. Velocità di ricarica minima richiesta in kilowatt. Un luogo con una tariffa di addebito inferiore a quella specificata viene filtrato.
connectorTypes[]

enum (EVConnectorType)

Campo facoltativo. L'elenco dei tipi di connettori EV preferiti. Una posizione che non supporta nessuno dei tipi di connettore elencati viene filtrata ed esclusa.