- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- RankPreference
- LocationBias
- LocationRestriction
- EVOptions
- ContextualContent
- Motivazione
- ReviewJustification
- HighlightedText
- HighlightedTextRange
- BusinessAvailabilityAttributesJustification
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 ( |
Campi | |
---|---|
textQuery |
Obbligatoria. La query di testo per la ricerca testuale. |
languageCode |
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 |
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 |
Come verranno classificati i risultati nella risposta. |
includedType |
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 |
Utilizzato per limitare la ricerca ai luoghi attualmente aperti. Il valore predefinito è false. |
minRating |
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 |
Deprecato: utilizza Il numero massimo di risultati che è possibile restituire per pagina. Se il numero di risultati disponibili è superiore a Se |
pageSize |
Campo facoltativo. Il numero massimo di risultati che è possibile restituire per pagina. Se il numero di risultati disponibili è superiore a Se |
pageToken |
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 |
priceLevels[] |
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 |
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 |
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 |
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 |
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 ( |
Campi | |
---|---|
places[] |
Un elenco di luoghi che soddisfano i criteri di ricerca testuale dell'utente. |
contextualContents[] |
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 |
nextPageToken |
Un token che può essere inviato come |
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 |
Campi | |
---|---|
Campo di unione
|
|
rectangle |
Un riquadro rettangolare definito dall'angolo nord-est e sud-ovest. |
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 |
Campi | |
---|---|
Campo di unione
|
|
rectangle |
Un riquadro rettangolare definito dall'angolo nord-est e sud-ovest. |
EVOptions
Opzioni EV ricercabili di una richiesta di ricerca di luoghi.
Rappresentazione JSON |
---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
Campi | |
---|---|
minimumChargingRateKw |
Campo facoltativo. Velocità di ricarica minima richiesta in kilowatt. Un luogo con una tariffa di addebito inferiore a quella specificata viene filtrato. |
connectorTypes[] |
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 ( |
Campi | |
---|---|
reviews[] |
Elenco di recensioni su questo luogo, attinenti alla query sul luogo. |
photos[] |
Informazioni (inclusi riferimenti) sulle foto di questo luogo, attinenti alla query sul luogo. |
justifications[] |
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 |
Campi | |
---|---|
Campo di unione
|
|
reviewJustification |
Sperimentale: per saperne di più, visita la pagina https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. |
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 ( |
Campi | |
---|---|
highlightedText |
|
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 ( |
Campi | |
---|---|
text |
|
highlightedTextRanges[] |
L'elenco degli intervalli di testo evidenziato. |
HighlightedTextRange
L'intervallo di testo evidenziato.
Rappresentazione JSON |
---|
{ "startIndex": integer, "endIndex": integer } |
Campi | |
---|---|
startIndex |
|
endIndex |
|
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 |
Se un luogo offre il servizio da asporto. |
delivery |
Se un luogo offre la consegna a domicilio. |
dineIn |
Se in un luogo è disponibile la consumazione sul posto. |