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
}
Campi
textQuery

string

Obbligatorio. La query di testo per la ricerca di testo.
languageCode

string

I dettagli del luogo verranno visualizzati nella lingua preferita, se disponibile. Se il codice lingua non è specificato o non è riconosciuto, è possibile che vengano restituiti i dettagli del luogo in qualsiasi lingua, 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, ad esempio 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)

La modalità di classificazione dei 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 è inferiore a questo limite. Un valore valido deve essere un numero con 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 in input verrà arrotondata per eccesso al valore 0,5 più vicino. 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 non viene fornito alcun valore o viene fornito il valore 0, viene utilizzato un valore predefinito di 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 non viene fornito alcun valore o viene fornito il valore 0, viene utilizzato un valore predefinito di 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. Fornisci questo valore per recuperare la pagina successiva.

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

enum (PriceLevel)

Utilizzato per limitare la ricerca ai luoghi contrassegnati come appartenenti a 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 dei tipi rigoroso per includedType. Se impostato su true, verranno restituiti solo 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 risultati relativi a una determinata località. Non può essere impostato insieme a locationRestriction.
locationRestriction

object (LocationRestriction)

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

object (EVOptions)

(Facoltativo) Imposta le opzioni EV disponibili per la ricerca di una richiesta di ricerca di luoghi.
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 raggiunge direttamente i clienti, ma non presta servizio ai clienti presso l'indirizzo aziendale. Ad esempio, attività come servizi di pulizia o idraulici. Queste attività non hanno un indirizzo fisico o una sede su Google Maps. Per queste attività, Places non restituirà campi tra cui location, plusCode e altri campi relativi alla posizione.

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)
    }
  ],
  "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 di routing in cui ogni voce è associata al luogo corrispondente nello stesso indice del campo places. Se il riepilogo del percorso non è disponibile per uno dei luoghi, conterrà una voce vuota. Se richiesto, questo elenco avrà tante voci quante quelle dell'elenco dei luoghi.
contextualContents[]

object (ContextualContent)

Sperimentale: per ulteriori dettagli, 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 al luogo corrispondente nello stesso indice nel campo Luoghi. I contenuti pertinenti al textQuery nella richiesta sono preferiti. 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 questa località. Se richiesto, questo elenco avrà tante voci quante quelle 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 ci sono pagine successive.
searchUri

string

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

RankPreference

La modalità di classificazione dei risultati nella risposta.

Enum
RANK_PREFERENCE_UNSPECIFIED Per una query categorica come "Ristoranti a New York", il valore predefinito è RELEVANZA. 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. Ordine di ordinamento determinato dalla normale pila del ranking.

LocationBias

La regione in cui cercare. Questa località funge da bias, il che significa che potrebbero essere restituiti 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)

Un riquadro rettangolare definito dagli 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 sud-ovest dell'area visibile del rettangolo. rectangle.low().latitude() non può essere maggiore di rectangle.high().latitude(). Verrà generato un intervallo di latitudine vuoto. L'area visibile di un rettangolo 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à funge da limitazione, il che significa che i risultati al di fuori della località indicata 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)

Un riquadro rettangolare definito dagli 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 sud-ovest dell'area visibile del rettangolo. rectangle.low().latitude() non può essere maggiore di rectangle.high().latitude(). Verrà generato un intervallo di latitudine vuoto. L'area visibile di un rettangolo non può essere più larga di 180 gradi.

EVOptions

Opzioni EV disponibili per la ricerca di una richiesta di ricerca di luoghi.

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

number

(Facoltativo) Potenza di ricarica minima richiesta in kilowatt. Un luogo con una tariffa di ricarica inferiore a quella specificata viene escluso.
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 un polilinea precalcolato dall'API Routes che definisce il percorso 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 influenzare i risultati di ricerca, questa opzione ti consente di influenzare i risultati lungo il percorso di un viaggio.

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

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

object (Polyline)

Obbligatorio. La polilinea del percorso.

Polilinea

Una polilinea del percorso. Supporta solo un polilinea codificato, che può essere passato come stringa e include la compressione con una perdita minima. Questa è l'uscita predefinita 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. Racchiude il tipo di polilinea. Il valore predefinito dell'output dell'API Routes è encoded_polyline. polyline_type può essere solo uno dei seguenti:
encodedPolyline

string

Una polilinea codificata, restituita dall'API Routes per impostazione predefinita. Consulta gli strumenti di codifica e decodifica.

ContextualContent

Sperimentale: per ulteriori dettagli, visita 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, contestualizzate 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, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Motivazioni per il luogo.

Giustificazione

Sperimentale: per ulteriori dettagli, 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 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, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
businessAvailabilityAttributesJustification

object (BusinessAvailabilityAttributesJustification)

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

ReviewJustification

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

Giustificazioni delle recensioni degli utenti. Viene evidenziata una sezione della recensione dell'utente che potrebbe interessare un utente finale. Ad esempio, se la query di ricerca è "pizza alla brace", la motivazione della recensione mette in evidenza 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. Nel testo potrebbero essere evidenziate 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, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. Giustificazioni di BusinessAvailabilityAttributes. Vengono mostrati 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 il servizio di consegna a domicilio.
dineIn

boolean

Se un luogo offre la consumazione sul posto.