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)
  },
  "routingParameters": {
    object (RoutingParameters)
  },
  "searchAlongRouteParameters": {
    object (SearchAlongRouteParameters)
  },
  "includePureServiceAreaBusinesses": boolean,
  "includeFutureOpeningBusinesses": boolean
}
Campi
textQuery

string

Obbligatorio. La query di testo per la ricerca testuale.
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.
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 un solo 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) con una cadenza di 0,5, ad esempio [0, 0,5, 1,0, ..., 5,0] inclusi. La valutazione inserita verrà arrotondata per eccesso al valore più vicino a 0,5. Ad esempio, una valutazione di 0,6 eliminerà tutti i risultati con una valutazione inferiore a 1,0.
maxResultCount
(deprecated)

integer

Deprecato: utilizza pageSize.

Il numero massimo di risultati per pagina che possono essere restituiti. Se il numero di risultati disponibili è maggiore di maxResultCount, viene restituito un nextPageToken che può essere passato a pageToken per ottenere la pagina successiva dei risultati nelle richieste successive. Se viene fornito il valore 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 vengono specificati sia maxResultCount che pageSize, maxResultCount verrà ignorato.
pageSize

integer

Facoltativo. Il numero massimo di risultati per pagina che possono essere restituiti. Se il numero di risultati disponibili è maggiore di pageSize, viene restituito un nextPageToken che può essere passato a pageToken per ottenere la pagina successiva dei risultati nelle richieste successive. Se viene fornito il valore 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 vengono specificati sia maxResultCount che pageSize, maxResultCount verrà ignorato.
pageToken

string

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

Durante la paginazione, tutti i parametri diversi da pageToken, pageSize e maxResultCount forniti a TextSearch devono corrispondere alla chiamata iniziale che ha fornito il token di pagina. In caso contrario, viene restituito un errore INVALID_ARGUMENT.
priceLevels[]

enum (PriceLevel)

Utilizzato per limitare la ricerca ai luoghi contrassegnati con 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 per includedType. Se impostato su true, verranno restituiti solo i risultati dello stesso tipo. Il valore predefinito è false.
locationBias

object (LocationBias)

La regione in cui eseguire la ricerca. Questa posizione funge da bias, il che significa che potrebbero essere restituiti risultati intorno alla posizione specificata. Non può essere impostato insieme a locationRestriction.
locationRestriction

object (LocationRestriction)

La regione in cui eseguire la ricerca. Questa località funge da limitazione, il che significa che i risultati al di fuori della località specificata non verranno restituiti. Non può essere impostato insieme a locationBias.
evOptions

object (EVOptions)

Facoltativo. Imposta le opzioni di ricerca di veicoli elettrici di una richiesta di ricerca di un luogo.
routingParameters

object (RoutingParameters)

Facoltativo. Parametri aggiuntivi per il routing ai risultati.
searchAlongRouteParameters

object (SearchAlongRouteParameters)

Facoltativo. Proto di parametri aggiuntivi per la ricerca lungo un percorso.
includePureServiceAreaBusinesses

boolean

Facoltativo. Includi le attività al domicilio del cliente se il campo è impostato su true. Un'attività al domicilio del cliente è un'attività che effettua consegne a domicilio o che raggiunge direttamente i clienti, ma che non presta servizio ai clienti presso l'indirizzo dell'attività. Ad esempio, attività come servizi di pulizia o idraulici. Queste attività non hanno un indirizzo fisico o una sede su Google Maps. Places non restituirà campi tra cui location, plusCode e altri campi correlati alla posizione per queste attività.
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 places.searchText.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "places": [
    {
      object (Place)
    }
  ],
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
  ],
  "contextualContents": [
    {
      object (ContextualContent)
    }
  ],
  "nextPageToken": string,
  "searchUri": string
}
Campi
places[]

object (Place)

Un elenco di luoghi che soddisfano i criteri di ricerca di testo dell'utente.
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 conterrà lo stesso numero di voci dell'elenco dei luoghi.
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 al luogo corrispondente nello stesso indice nel campo Luoghi. Sono preferiti i contenuti pertinenti a textQuery nella richiesta. Se i contenuti contestuali non sono disponibili per uno dei luoghi, verranno restituiti contenuti non contestuali. Sarà vuoto solo quando i contenuti non sono disponibili per questo luogo. Se richiesto, questo elenco conterrà lo stesso numero di voci dell'elenco dei luoghi.
nextPageToken

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso o è vuoto, non verranno visualizzate altre pagine.
searchUri

string

Un link consente all'utente di eseguire una ricerca con la stessa query di testo specificata nella richiesta su Google Maps.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

RankPreference

Come verranno classificati i risultati nella risposta.

Enum
RANK_PREFERENCE_UNSPECIFIED Per una query categorica come "Ristoranti a New York City", la pertinenza è l'impostazione predefinita. Per le query non categoriche come "Mountain View, CA", ti consigliamo di lasciare rankPreference non impostato.
DISTANCE Ordina i risultati in base alla distanza.
RELEVANCE Classifica i risultati in base alla pertinenza. L'ordine di ordinamento è determinato dalla normale pila di ranking.

LocationBias

La regione in cui eseguire la ricerca. Questa posizione funge da bias, il che significa che potrebbero essere restituiti risultati intorno alla posizione specificata.

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

object (Viewport)

Un rettangolo definito dagli angoli nord-est e sud-ovest. rectangle.high() deve essere il punto nord-est del riquadro di visualizzazione rettangolare. rectangle.low() deve essere il punto sud-ovest del riquadro di visualizzazione rettangolare. rectangle.low().latitude() non può essere maggiore di rectangle.high().latitude(). Verrà generato un intervallo di latitudine vuoto. Un riquadro rettangolare non può essere più ampio di 180 gradi.
circle

object (Circle)

Un cerchio definito dal punto centrale e dal raggio.

LocationRestriction

La regione in cui eseguire la ricerca. Questa località funge da limitazione, il che significa che i risultati al di fuori della località specificata 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 tipi:
rectangle

object (Viewport)

Un rettangolo definito dagli angoli nord-est e sud-ovest. rectangle.high() deve essere il punto nord-est del riquadro di visualizzazione rettangolare. rectangle.low() deve essere il punto sud-ovest del riquadro di visualizzazione rettangolare. rectangle.low().latitude() non può essere maggiore di rectangle.high().latitude(). Verrà generato un intervallo di latitudine vuoto. Un riquadro rettangolare non può essere più ampio di 180 gradi.

EVOptions

Opzioni EV ricercabili di una richiesta di ricerca di un luogo.

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

number

Facoltativo. Tasso di ricarica minimo richiesto in kilowatt. Un luogo con una velocità di ricarica inferiore a quella specificata viene filtrato.
connectorTypes[]

enum (EVConnectorType)

Facoltativo. L'elenco dei tipi di connettori EV preferiti. Un luogo che non supporta nessuno dei tipi di connettore elencati viene escluso.

SearchAlongRouteParameters

Specifica una polilinea precalcolata dall'API Routes che definisce l'itinerario da cercare. La ricerca lungo un percorso è simile all'utilizzo dell'opzione di richiesta locationBias o locationRestriction per orientare i risultati di ricerca. Tuttavia, mentre le opzioni locationBias e locationRestriction ti consentono di specificare una regione per orientare i risultati di ricerca, questa opzione ti consente di orientare i risultati lungo un itinerario.

Non è garantito che i risultati si trovino lungo l'itinerario fornito, ma vengono classificati all'interno dell'area di ricerca definita dalla polilinea e, facoltativamente, da locationBias o locationRestriction in base ai tempi di deviazione minimi dall'origine alla destinazione. I risultati potrebbero riguardare un percorso alternativo, soprattutto se la polilinea fornita non definisce un percorso ottimale dall'origine alla destinazione.

Rappresentazione JSON 
{
  "polyline": {
    object (Polyline)
  }
}
Campi
polyline

object (Polyline)

Obbligatorio. La polilinea dell'itinerario.

Polilinea

Una polilinea dell'itinerario. Supporta solo una polilinea codificata, che può essere passata come stringa e include la compressione con una perdita minima. Questo è l'output predefinito dell'API Routes.

Rappresentazione JSON 
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string
  // End of list of possible types for union field polyline_type.
}
Campi
Campo unione polyline_type. Contiene il tipo di polilinea. L'output dell'API Routes è impostato per impostazione predefinita su encoded_polyline. polyline_type può essere solo uno dei seguenti tipi:
encodedPolyline

string

Una polilinea codificata, restituita per impostazione predefinita dall'API Routes. Consulta gli strumenti encoder e decoder.

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 delle recensioni su questo luogo, contestuali alla query sul luogo.
photos[]

object (Photo)

Informazioni (inclusi i riferimenti) sulle foto di questo luogo, contestuali 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. Le motivazioni rispondono alla domanda sul perché un luogo potrebbe 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 tipi:
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 delle recensioni degli utenti. In questo modo viene evidenziata una sezione della recensione dell'utente che potrebbe interessare un utente finale. Ad esempio, se la query di ricerca è "pizza cotta 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 da HighlightedTextRange. Potrebbero essere evidenziate diverse parole nel testo.

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. Giustificazioni di 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 cibo da asporto.
delivery

boolean

Se un luogo offre la consegna a domicilio.
dineIn

boolean

Se un luogo offre la consumazione sul posto.