Una ricerca testuale (novità) restituisce informazioni su un insieme di posizioni in base a una stringa, ad esempio "pizza a Roma" o "negozi di scarpe vicino a Roma" o "Via Cavour 123". La Il servizio risponde con un elenco di posizioni corrispondenti alla stringa di testo e a qualsiasi posizione pregiudizi esistenti.
Il servizio è particolarmente utile per query relative a indirizzi ambigui in un sistema automatico e i componenti diversi dall'indirizzo della stringa potrebbero corrispondere attività commerciali e indirizzi. Esempi di query di indirizzi ambigui: indirizzi con formattazione scadente o richieste che includono componenti diversi dall'indirizzo, come come nomi delle attività. Richieste come i primi due esempi nella tabella seguente potrebbe restituire zero risultati, a meno che non venga specificata una località, ad esempio regione, località o bias per località.
"Via Roma 10, Italia" o "123 Main Street, US" | Diverse "High Street" nel Regno Unito; più "Main Street" negli Stati Uniti. La query non restituisce risultati desiderabili a meno che non venga applicata una restrizione di località per iniziare. |
"ChainRestaurant New York" | Più "ChainRestaurant" sedi a New York; nessun indirizzo oppure e persino il nome della via. |
"10 High Street, Escher Regno Unito" o "123 Main Street, Pleasanton US" | Solo una "High Street" nella città di Escher nel Regno Unito; solo una "Main Street" nella città di Pleasanton in California. |
"UniqueRestaurantName New York" | Solo una struttura con questo nome a New York; nessuna via necessari per differenziare. |
"pizzerie a Roma" | Questa query contiene la relativa limitazione di località e "pizzerie" sono un tipo di luogo ben definito. Restituisce più risultati. |
"+1 514-670-8700" | Questa query contiene un numero di telefono. Restituisce più risultati per luoghi associati a quel numero di telefono. |
Explorer API ti consente di effettuare richieste in tempo reale per familiarizzare con l'API e Opzioni API:
Richieste di ricerca testuale
Una richiesta di ricerca testuale è una richiesta POST HTTP con il seguente formato:
https://places.googleapis.com/v1/places:searchText
Passa tutti i parametri nel corpo della richiesta JSON o nelle intestazioni come parte del richiesta POST. Ad esempio:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
Risposte della Ricerca testuale (nuove)
La ricerca testuale (Nuova) restituisce un come risposta. Nella risposta:
- L'array
places
contiene tutti i luoghi corrispondenti. - Ogni punto dell'array è rappresentato da un
Place
. L'oggettoPlace
contiene informazioni dettagliate su un singolo posto. - La FieldMask passata nella richiesta specifica la
elenco dei campi restituiti nell'oggetto
Place
.
L'oggetto JSON completo ha il seguente formato:
{ "places": [ { object (Place) } ] }
Parametri obbligatori
-
FieldMask
Specifica l'elenco dei campi da restituire nella risposta creando un maschera del campo di risposta. Passa la maschera del campo di risposta al metodo utilizzando il parametro URL
$fields
ofields
oppure tramite l'intestazione HTTPX-Goog-FieldMask
. La risposta non contiene un elenco predefinito dei campi restituiti. Se ometti la maschera di campo, il metodo restituisce un errore.Il mascheramento dei campi è una buona pratica di progettazione per garantire di dati non necessari, così da evitare tempi di elaborazione non necessari addebiti di fatturazione.
Specifica un elenco separato da virgole dei tipi di dati dei luoghi da restituire. Ad esempio: per recuperare il nome visualizzato e l'indirizzo del luogo.
X-Goog-FieldMask: places.displayName,places.formattedAddress
Utilizza
*
per recuperare tutti i campi.X-Goog-FieldMask: *
Specifica uno o più dei seguenti campi:
I seguenti campi attivano lo SKU Ricerca testuale (solo ID):
places.attributions
,places.id
,places.name
*,nextPageToken
* Il campoplaces.name
contiene il luogo nome risorsa nel formato:places/PLACE_ID
. Usaplaces.displayName
per accedere al nome testuale del luogo.I seguenti campi attivano lo SKU Ricerca testuale (di base):
places.accessibilityOptions
,places.addressComponents
,places.adrFormatAddress
,places.businessStatus
,places.displayName
,places.formattedAddress
,places.googleMapsUri
,places.iconBackgroundColor
,places.iconMaskBaseUri
,places.location
,places.photos
,places.plusCode
,places.primaryType
,places.primaryTypeDisplayName
,places.shortFormattedAddress
,places.subDestinations
,places.types
,places.utcOffsetMinutes
,places.viewport
I seguenti campi attivano lo SKU Ricerca testuale (avanzata):
places.currentOpeningHours
,places.currentSecondaryOpeningHours
,places.internationalPhoneNumber
,places.nationalPhoneNumber
,places.priceLevel
,places.rating
,places.regularOpeningHours
,places.regularSecondaryOpeningHours
,places.userRatingCount
,places.websiteUri
I seguenti campi attivano lo SKU Ricerca testuale (preferito):
places.allowsDogs
,places.curbsidePickup
,places.delivery
,places.dineIn
,places.editorialSummary
,places.evChargeOptions
,places.fuelOptions
,places.goodForChildren
,places.goodForGroups
,places.goodForWatchingSports
,places.liveMusic
,places.menuForChildren
,places.parkingOptions
,places.paymentOptions
,places.outdoorSeating
,places.reservable
,places.restroom
,places.reviews
,places.servesBeer
,places.servesBreakfast
,places.servesBrunch
,places.servesCocktails
,places.servesCoffee
,places.servesDessert
,places.servesDinner
,places.servesLunch
,places.servesVegetarianFood
,places.servesWine
,places.takeout
-
textQuery
La stringa di testo su cui cercare, ad esempio: "ristorante", "123 Main Street" o "luogo migliore da visitare a San Francisco". L'API restituisce le corrispondenze dei candidati in base su questa stringa e ordina i risultati in base alla loro pertinenza percepita.
Parametri facoltativi
includedType
Limita i risultati alle posizioni corrispondenti al tipo specificato definito da Tabella A. È possibile specificare un solo tipo. Ad esempio:
"includedType":"bar"
"includedType":"pharmacy"
languageCode
La lingua in cui restituire i risultati.
- Consulta le elenco delle lingue supportate. Google aggiorna spesso le lingue supportate, pertanto questo elenco potrebbe non essere esaustivi.
-
Se
languageCode
non viene fornito, l'API predefinitaen
. Se specifichi un codice lingua non valido, l'API restituisce un erroreINVALID_ARGUMENT
. - L'API fa del suo meglio per fornire una via facilmente leggibile sia l'utente che la gente del posto. Per raggiungere l'obiettivo, restituisce il codice nella lingua locale, traslitterati in uno script leggibile all'utente, se necessario, osservando la lingua preferita. Tutti gli altri indirizzi vengono restituiti nella lingua preferita. I componenti dell'indirizzo tutti restituiti nella stessa lingua, che viene scelta tra la prima di strumento di authoring.
- Se un nome non è disponibile nella lingua preferita, l'API utilizza la classe la corrispondenza più simile.
- La lingua preferita ha una piccola influenza sull'insieme di risultati che che l'API sceglie di restituire e l'ordine in cui vengono restituiti. La il geocodificatore interpreta le abbreviazioni in modo diverso a seconda della lingua, come le abbreviazioni dei tipi di strada o i sinonimi che potrebbero validi in una lingua, ma non in un'altra.
locationBias
Specifica un'area in cui eseguire la ricerca. Questa località funge da bias, che significa è possibile restituire risultati relativi alla località specificata, inclusi i risultati al di fuori dell'area specificata.
Puoi specificare
locationRestriction
olocationBias
, ma non entrambi. ConsideralocationRestriction
come una specifica regione in cui devono essere contenuti i risultati elocationBias
come che specifica la regione alla quale i risultati devono essere vicini, ma che possono essere al di fuori della zona.Specifica la regione come un'area visibile rettangolare o circolare.
Un cerchio viene definito dal centro e dal raggio in metri. Il raggio deve essere compreso tra 0,0 e 50000,0 inclusi. Il raggio predefinito è 0,0. Ad esempio:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
Un rettangolo è un'area visibile di latitudine e longitudine, rappresentata da due diagonalmente opposte ai punti bassi e alti. Il punto più basso indica il sud-ovest angolo del rettangolo e il punto più alto rappresenta il nord-est angolo del rettangolo.
Un'area visibile è considerata un regione chiusa, ovvero include il confine. I limiti di latitudine deve essere compreso tra -90 e 90 gradi inclusi e i limiti di longitudine deve essere compreso tra -180 e 180 gradi inclusi:
- Se
low
=high
, l'area visibile è composta da quel singolo punto. - Se
low.longitude
>high.longitude
, l'intervallo di longitudine è invertito (l'area visibile attraversa i 180 gradi longitudine). - Se
low.longitude
= -180 gradi ehigh.longitude
= 180 gradi, l'area visibile include tutti longitudini. - Se
low.longitude
= 180 gradi ehigh.longitude
= -180 gradi, l'intervallo di longitudine è vuoto. - Se
low.latitude
>high.latitude
, l'intervallo di latitudine è vuoto.
Devono essere compilati sia il valore basso che quello alto e la casella rappresentata non può essere vuoto. Un'area visibile vuota genera un errore.
Ad esempio, questa area visibile racchiude completamente New York City:
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
- Se
locationRestriction
Specifica un'area in cui eseguire la ricerca. I risultati al di fuori dell'area specificata non sono restituito. Specifica la regione come un'area visibile rettangolare. Leggi la descrizione di
locationBias
per informazioni sulla definizione dell'area visibile.Puoi specificare
locationRestriction
olocationBias
, ma non entrambi. ConsideralocationRestriction
come una specifica regione in cui devono essere contenuti i risultati elocationBias
come che specifica la regione alla quale i risultati devono essere vicini, ma che possono essere al di fuori della zona.-
maxResultCount (deprecato)
Specifica il numero di risultati (compreso tra 1 e 20) da visualizzare per pagina. Ad esempio, se imposti un valore 5 per
maxResultCount
, verrà restituito fino a 5 i risultati nella prima pagina. Se è possibile restituire un numero maggiore di risultati dalla query, la risposta include unnextPageToken
che può passare a una richiesta successiva di accesso alla pagina successiva. evOptions
Specifica i parametri per identificare il veicolo elettrico (EV) disponibile connettori di ricarica e velocità di ricarica.
connectorTypes
Filtri in base al tipo di connettore di ricarica EV disponibile in un luogo. R la posizione che non supporta alcun tipo di connettore sarà filtrata fuori. I tipi di connettori di ricarica EV supportati includono quelli combinati (CA e CC) caricabatterie, caricabatterie Tesla, caricabatterie conformi a GB/T (per la ricarica rapida EV Cina) e caricabatterie a muro. Per ulteriori informazioni, consulta il riferimento documentazione.
minimumChargingRateKw
Filtra i luoghi in base alla velocità di ricarica minima del veicolo elettrico in kilowatt (kW). Qualsiasi luoghi con una tariffa di ricarica inferiore a quella minima sono esclusi. Ad esempio, per trovare stazioni di ricarica EV con velocità di ricarica che sono almeno 10 kW, puoi impostare questo parametro su "10".
minRating
Limita i risultati solo agli utenti con valutazione media degli utenti superiore a o uguale a questo limite. I valori devono essere compresi tra 0,0 e 5,0 (incluso) in di 0,5. Ad esempio: 0, 0,5, 1,0, ... , 5,0 inclusi. I valori sono arrotondato per eccesso al valore più vicino a 0,5. Ad esempio, un valore pari a 0,6 elimina tutti con una valutazione inferiore a 1,0.
openNow
Se
true
, restituisce solo i luoghi aperti. nel momento in cui la query viene inviata. Sefalse
, restituisci tutte le attività indipendentemente dallo stato aperto. I luoghi che non specificano l'orario di apertura nel database di Google Places se imposti questo parametro sufalse
.pageSize
Specifica il numero di risultati (compreso tra 1 e 20) da visualizzare per pagina. Ad esempio, se imposti un valore 5 per
pageSize
, verrà restituito fino a 5 i risultati nella prima pagina. Se è possibile restituire un numero maggiore di risultati dalla query, la risposta include unnextPageToken
che può passare a una richiesta successiva di accesso alla pagina successiva.pageToken
Specifica
nextPageToken
nel corpo della risposta dell' pagina precedente.-
priceLevels
Restringi la ricerca ai luoghi contrassegnati a determinati livelli di prezzo. Per impostazione predefinita, vengono selezionati tutti i livelli di prezzo.
Specifica un array di uno o più valori definiti da
PriceLevel
Ad esempio:
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
rankPreference
Specifica il ranking dei risultati nella risposta in base al tipo di query:
- Per una query categorica come "Ristoranti a New York",
RELEVANCE
(ranking dei risultati per pertinenza della ricerca) è l'impostazione predefinita. Puoi impostarerankPreference
suRELEVANCE
oppureDISTANCE
(ranking dei risultati in base alla distanza). - Per una query non categorica come "Mountain View, CA", ti consigliamo
devi lasciare
rankPreference
non impostato.
- Per una query categorica come "Ristoranti a New York",
regionCode
Il codice regione utilizzato per formattare la risposta, specificato come codice CLDR a due caratteri. Questo parametro può anche avere un effetto bias nei risultati di ricerca. Non esiste un valore predefinito.
Se il nome del paese nel campo
formattedAddress
nella la risposta corrisponde aregionCode
, il codice paese viene omesso daformattedAddress
. Questo parametro non ha alcun effetto suadrFormatAddress
, che include sempre il paese quando è disponibile oppure sushortFormattedAddress
, che non sempre la include.La maggior parte dei codici CLDR è identica ai codici ISO 3166-1, con alcune degne di nota. Ad esempio, il ccTLD del Regno Unito è "uk" (.co.uk) mentre il codice ISO 3166-1 è "gb" (tecnicamente per persona giuridica del "Regno Unito di Gran Bretagna e Irlanda del Nord"). Il parametro può influire sui risultati in base alla legge vigente.
strictTypeFiltering
Utilizzato con il parametro
includedType
. Se impostato sutrue
, solo le località che corrispondono ai tipi specificati specificati da Vengono restituitiincludeType
. Se il valore è false, il valore predefinito è la risposta che può contenere luoghi che non corrispondono dei tipi specificati.
Esempi di ricerca testuale
Trova un luogo tramite la stringa di query
L'esempio seguente mostra una richiesta di ricerca testuale per "Cibo vegetariano piccante a Sydney, Australia":
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
Tieni presente che l'intestazione X-Goog-FieldMask
specifica che
risposta
contiene i seguenti campi di dati: places.displayName,places.formattedAddress
.
La risposta avrà quindi il seguente formato:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, { "formattedAddress": "29 King St, Sydney NSW 2000, Australia", "displayName": { "text": "Peace Harmony", "languageCode": "en" } }, ... ] }
Aggiungi altri tipi di dati alla maschera del campo per restituire informazioni aggiuntive.
Ad esempio, aggiungi places.types,places.websiteUri
per includere il parametro
il tipo di ristorante e l'indirizzo web nel
response:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.types,places.websiteUri' \ 'https://places.googleapis.com/v1/places:searchText'
La risposta è ora nel formato:
{ "places": [ { "types": [ "vegetarian_restaurant", "vegan_restaurant", "chinese_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "websiteUri": "http://www.motherchusvegetarian.com.au/", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "types": [ "vegan_restaurant", "thai_restaurant", "vegetarian_restaurant", "indian_restaurant", "italian_restaurant", "american_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "websiteUri": "http://www.veggosizzle.com.au/", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, ... ] }
Filtra i luoghi per livello di prezzo
Utilizza l'opzione priceLevel
per filtrare i risultati in base ai ristoranti
definiti come economici o moderatamente costosi:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia", "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"] }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
Questo esempio utilizza anche l'intestazione X-Goog-FieldMask
per aggiungere
places.priceLevel
alla
risposta
quindi ha questo formato:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "115 King St, Newtown NSW 2042, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Green Mushroom", "languageCode": "en" } }, ... ] }
Aggiungi altre opzioni per perfezionare la ricerca, ad esempio includedType
,
minRating
, rankPreference
, openNow
e altri parametri descritti in
Parametri facoltativi.
Cercare luoghi in un'area
Usa locationRestriction
o locationBias
,
ma non entrambi, per limitare la ricerca a un'area. Pensa a locationRestriction
come specificare la regione in cui devono trovarsi i risultati e locationBias
specifica la regione alla quale i risultati devono essere vicini, ma possono essere al di fuori
della zona.
L'esempio seguente mostra una richiesta di ricerca testuale per "Cibo vegetariano piccante" che si trovi entro i 500 metri di distanza centro di San Francisco. Questa richiesta restituisce solo i primi 10 risultati per luoghi aperti.
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food", "openNow": true, "pageSize": 10, "locationBias": { "circle": { "center": {"latitude": 37.7937, "longitude": -122.3965}, "radius": 500.0 } }, }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
Cerca stazioni di ricarica EV con una velocità di ricarica minima
Usa minimumChargingRateKw
e connectorTypes
per
cercare luoghi con stazioni di ricarica disponibili compatibili con il tuo EV.
L'esempio seguente mostra una richiesta per la ricarica EV di tipo 1 Tesla e J1772 con una velocità di ricarica minima di 10 kW a Mountain View, in California. Solo quattro vengono restituiti i risultati.
curl -X POST -d '{ "textQuery": "EV Charging Station Mountain View", "pageSize": 4, "evOptions": { "minimumChargingRateKw": 10, "connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"] } }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \ 'https://places.googleapis.com/v1/places:searchText'
La richiesta restituisce la seguente risposta:
{ "places": [ { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 16, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 100, "count": 8, "availableCount": 5, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 2, "availableCount": 2, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 6, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 6, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 4, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 2, "availableCount": 0, "outOfServiceCount": 2, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 5, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_J1772", "maxChargeRateKw": 3.5999999046325684, "count": 1, "availableCount": 0, "outOfServiceCount": 1, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "Electric Vehicle Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 10, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_OTHER", "maxChargeRateKw": 210, "count": 10 } ] } } ] }
Specifica un numero di risultati da restituire per pagina
Utilizza il parametro pageSize
per specificare un numero di risultati per
reso per pagina. Parametro nextPageToken
nel corpo della risposta
fornisce un token che può essere utilizzato nelle chiamate successive per accedere alla pagina successiva
che consentono di analizzare i dati
e visualizzare i risultati.
L'esempio seguente mostra una richiesta per "pizza a New York" un massimo di 5 risultati per pagina:
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5 }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJifIePKtZwokRVZ-UdRGkZzs" }, { "id": "ChIJPxPd_P1YwokRfzLhSiACEoU" }, { "id": "ChIJrXXKn5NZwokR78g0ipCnY60" }, { "id": "ChIJ6ySICVZYwokR9rIK8HjXhzE" }, { "id": "ChIJ6xvs94VZwokRnT1D2lX2OTw" } ], "nextPageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }
Per accedere alla pagina successiva di risultati, utilizza pageToken
per passare
nextPageToken
nel corpo della richiesta:
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5, "pageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJL-LN1N1ZwokR8K2jACu6Ydw" }, { "id": "ChIJjaD94kFZwokR-20CXqlpy_4" }, { "id": "ChIJ6ffdpJNZwokRmcafdROM5q0" }, { "id": "ChIJ8Q2WSpJZwokRQz-bYYgEskM" }, { "id": "ChIJ8164qwFZwokRhplkmhvq1uE" } ], "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c" }
Prova
Explorer API ti consente di effettuare richieste di esempio di acquisire familiarità con le opzioni dell'API e delle API.
Seleziona l'icona dell'API
. sul lato destro della pagina.
Se vuoi, espandi Mostra parametri standard e imposta il
fields
parametro al campo maschera.Se vuoi, modifica il corpo della richiesta.
Seleziona il pulsante Esegui. Nella finestra di dialogo popup, scegli l'account con da utilizzare per effettuare la richiesta.
Nel riquadro Explorer API, seleziona l'icona Espandi,
, per espandere la finestra Explorer API.