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,
  "pageSize": integer,
  "pageToken": string,
  "priceLevels": [
    enum (PriceLevel)
  ],
  "strictTypeFiltering": boolean,
  "locationBias": {
    object (LocationBias)
  },
  "locationRestriction": {
    object (LocationRestriction)
  },
  "evOptions": {
    object (EVOptions)
  }
}
Campi
textQuery

string

Obbligatorio. La query di testo per la ricerca testuale.
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.
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. Supporta 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 è rigorosamente 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, ad esempio [0, 0,5, 1,0, ..., 5,0] inclusi. La valutazione dell'input viene arrotondata per eccesso al valore più vicino allo 0,5(massimo). Ad esempio, una valutazione pari a 0,6 eliminerà tutti i risultati con una valutazione inferiore a 1,0.
maxResultCount
(deprecated)

integer

Deprecato: usa invece pageSize.

Il numero massimo di risultati che è possibile restituire per pagina. Se il numero di risultati disponibili è superiore a maxResultCount, viene restituito un nextPageToken che può essere passato a pageToken per ottenere la pagina dei risultati successiva nelle richieste successive. Se il valore è 0 o non viene fornito, viene utilizzato il valore predefinito 20. Il valore massimo è 20. i valori superiori a 20 verranno forzati a 20. I valori negativi restituiranno un errore INVALID_ARGUMENT.

Se maxResultCount e pageSize sono specificati, maxResultCount verrà ignorato.
pageSize

integer

(Facoltativo) Il numero massimo di risultati che è possibile restituire per pagina. Se il numero di risultati disponibili è superiore a pageSize, viene restituito un nextPageToken che può essere passato a pageToken per ottenere la pagina dei risultati successiva nelle richieste successive. Se il valore è 0 o non viene fornito, viene utilizzato il valore predefinito 20. Il valore massimo è 20. i valori superiori a 20 verranno impostati su 20. I valori negativi restituiranno un errore INVALID_ARGUMENT.

Se maxResultCount e pageSize sono specificati, maxResultCount verrà ignorato.
pageToken

string

(Facoltativo) Un token di pagina, ricevuto da una precedente chiamata TextSearch. Forniscilo per recuperare la pagina successiva.

Durante l'impaginazione, tutti i parametri diversi da pageToken, pageSize e maxResultCount forniti a TextSearch devono corrispondere alla chiamata iniziale che ha fornito il token della pagina. In caso contrario, 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 di tipo rigoroso per inclusoType. Se il criterio viene impostato su true, vengono restituiti solo i risultati dello stesso tipo. Il valore predefinito è false.
locationBias

object (LocationBias)

La regione in cui eseguire la ricerca. Questa località funge da bias, perciò potrebbe restituire risultati relativi a una determinata località. Non può essere impostato insieme a locationRestrict.
locationRestriction

object (LocationRestriction)

La regione in cui eseguire la ricerca. Questa località rappresenta una limitazione, pertanto i risultati al di fuori di una determinata località non verranno restituiti. Non può essere impostato insieme al locationBias.
evOptions

object (EVOptions)

(Facoltativo) Imposta le opzioni di veicoli elettrici 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)
    }
  ],
  "contextualContents": [
    {
      object (ContextualContent)
    }
  ],
  "nextPageToken": string
}
Campi
places[]

object (Place)

Un elenco di luoghi che soddisfano i criteri di ricerca testuale dell'utente.
contextualContents[]

object (ContextualContent)

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Un elenco di contenuti contestuali in cui ogni voce è associata alla posizione corrispondente nello stesso indice nel campo Luoghi. Sono preferibili i contenuti pertinenti al criterio textQuery nella richiesta. Se i contenuti contestuali non sono disponibili per uno dei luoghi, verranno restituiti contenuti non contestuali. Sarà vuota solo se i contenuti non sono disponibili per questo luogo. Questo elenco deve contenere un numero di voci pari a quello dell'elenco di luoghi, se richiesto.
nextPageToken

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso o vuoto, non ci saranno pagine successive.

RankPreference

Come verranno classificati i risultati nella risposta.

Enum
RANK_PREFERENCE_UNSPECIFIED Per una query con categoria come "Ristoranti a New York", il valore predefinito è RELEVANCE. Per query non categoriche, ad esempio "Mountain View, CA" ti consigliamo di non impostare il valore rankPreference.
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 eseguire la ricerca. Questa località funge da bias, perciò potrebbe restituire 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 unione type.

type può essere solo uno dei seguenti:
rectangle

object (Viewport)

Una casella rettangolare definita da angoli nord-est e sud-ovest. rectangle.high() deve essere il punto nord-est dell'area visibile del rettangolo. rectangle.low() deve essere il punto a sud-ovest dell'area visibile del rettangolo. Il valore rectangle.low().latitude() non può essere superiore a rectangle.high().latitude(). L'intervallo di latitudine sarà vuoto. Un'area visibile rettangolare non può essere più larga di 180 gradi.
circle

object (Circle)

Un cerchio definito dal centro e dal raggio.

LocationRestriction

La regione in cui eseguire la ricerca. Questa località rappresenta una limitazione, pertanto i risultati al di fuori di una determinata 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 unione type.

type può essere solo uno dei seguenti:
rectangle

object (Viewport)

Una casella rettangolare definita da angoli nord-est e sud-ovest. rectangle.high() deve essere il punto nord-est dell'area visibile del rettangolo. rectangle.low() deve essere il punto a sud-ovest dell'area visibile del rettangolo. Il valore rectangle.low().latitude() non può essere superiore a rectangle.high().latitude(). L'intervallo di latitudine sarà vuoto. Un'area visibile rettangolare non può essere più larga di 180 gradi.

EVOptions

Opzioni di veicoli elettrici disponibili per la ricerca di una richiesta di ricerca di luoghi.

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

number

(Facoltativo) Velocità di ricarica minima richiesta in kilowatt. Un luogo con una tariffa di addebito inferiore a quella specificata viene escluso.
connectorTypes[]

enum (EVConnectorType)

(Facoltativo) L'elenco dei tipi di connettori EV preferiti. Le località che non supportano i tipi di connettori elencati vengono filtrate.

ContextualContent

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Contenuti contestuali alla query sul luogo.

Rappresentazione JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "justifications": [
    {
      object (Justification)
    }
  ]
}
Campi
reviews[]

object (Review)

Elenco di recensioni su questo luogo, in linea con la query sul luogo.
photos[]

object (Photo)

Informazioni (inclusi riferimenti) sulle foto di questo luogo, correlate alla query sul luogo.
justifications[]

object (Justification)

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Motivazioni per il luogo.

Giustificazione

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Motivazioni per il luogo. La sezione Motivazioni risponde alla domanda sul perché un luogo può interessare un utente finale.

Rappresentazione JSON 
{

  // Union field justification can be only one of the following:
  "reviewJustification": {
    object (ReviewJustification)
  },
  "businessAvailabilityAttributesJustification": {
    object (BusinessAvailabilityAttributesJustification)
  }
  // End of list of possible types for union field justification.
}
Campi

Campo unione justification.

justification può essere solo uno dei seguenti:
reviewJustification

object (ReviewJustification)

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
businessAvailabilityAttributesJustification

object (BusinessAvailabilityAttributesJustification)

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

ReviewJustification

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Motivazioni della revisione dell'utente. In questo modo evidenzia una sezione della recensione dell'utente che potrebbe interessare un utente finale. Ad esempio, se la query di ricerca è "pizza legna da ardere", la giustificazione della recensione evidenzia il testo pertinente alla query di ricerca.

Rappresentazione JSON 
{
  "highlightedText": {
    object (HighlightedText)
  },
  "review": {
    object (Review)
  }
}
Campi
highlightedText

object (HighlightedText)
review

object (Review)

La recensione da cui viene generato il testo evidenziato.

HighlightedText

Il testo evidenziato dalla motivazione. Questo è un sottoinsieme della recensione stessa. La parola esatta da evidenziare è contrassegnata dall'opzione HighlightedTextRange. Il testo evidenziato potrebbe contenere diverse parole.

Rappresentazione JSON 
{
  "text": string,
  "highlightedTextRanges": [
    {
      object (HighlightedTextRange)
    }
  ]
}
Campi
text

string
highlightedTextRanges[]

object (HighlightedTextRange)

L'elenco degli intervalli del testo evidenziato.

HighlightedTextRange

L'intervallo di testo evidenziato.

Rappresentazione JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
Campi
startIndex

integer
endIndex

integer

BusinessAvailabilityAttributesJustification

Sperimentale: per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Motivazioni per BusinessavailabilityAttributes. Mostra alcuni attributi di un'attività che potrebbero interessare un utente finale.

Rappresentazione JSON 
{
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean
}
Campi
takeout

boolean

Se un luogo offre il servizio di asporto.
delivery

boolean

Se un luogo offre la consegna a domicilio.
dineIn

boolean

Se un luogo offre la consumazione sul posto.