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

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
(deprecated)

integer

Deprecato: utilizza 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 trasmesso a pageToken per ottenere la pagina successiva dei risultati nelle richieste successive. Se viene fornito un valore pari a 0 o nessun valore, 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

Campo 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 trasmesso a pageToken per ottenere la pagina successiva dei risultati nelle richieste successive. Se viene fornito un valore pari a 0 o nessun valore, 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

Campo facoltativo. Un token di pagina, ricevuto da una precedente chiamata TextSearch. Specifica questo valore 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 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)
    }
  ],
  "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 saperne di più, visita 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 Places. I contenuti pertinenti a textQuery nella richiesta sono preferiti. Se i contenuti contestuali non sono disponibili per uno dei luoghi, verranno restituiti contenuti non contestuali. Il campo sarà vuoto solo quando i contenuti non saranno disponibili per questo luogo. Questo elenco deve contenere tante voci quante sono le voci 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 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.

ContextualContent

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Contenuti contestuali alla query del luogo.

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

object (Review)

Elenco di recensioni su questo luogo, attinenti alla query sul luogo.
photos[]

object (Photo)

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

object (Justification)

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Motivazioni per il luogo.

Motivazione

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Motivazioni per il luogo. Le giustificazioni rispondono alla domanda sul motivo per cui un luogo potrebbe essere interessante per 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 di unione justification.

justification può essere solo uno dei seguenti:
reviewJustification

object (ReviewJustification)

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
businessAvailabilityAttributesJustification

object (BusinessAvailabilityAttributesJustification)

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

ReviewJustification

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Motivazioni delle recensioni dell'utente. In questo modo viene evidenziata una sezione della recensione dell'utente che potrebbe interessare a un utente finale. Ad esempio, se la query di ricerca è "pizza a legna", 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 giustificazione. Si tratta di un sottoinsieme della recensione stessa. La parola esatta da evidenziare è contrassegnata dall'elemento HighlightedTextRange. Il testo potrebbe essere evidenziato in diverse parole.

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

string
highlightedTextRanges[]

object (HighlightedTextRange)

L'elenco degli intervalli di testo evidenziato.

HighlightedTextRange

L'intervallo di testo evidenziato.

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

integer
endIndex

integer

BusinessAvailabilityAttributesJustification

Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Motivazioni 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 da asporto.
delivery

boolean

Se un luogo offre la consegna a domicilio.
dineIn

boolean

Se in un luogo è disponibile la consumazione sul posto.