Una ricerca testuale (nuova) restituisce informazioni su un insieme di luoghi in base a una stringa, ad esempio "pizza a New York" o "negozi di scarpe vicino a Ottawa" o "123 Main Street". Il servizio risponde con un elenco di posizioni corrispondenti alla stringa di testo e gli eventuali bias relativi alla località impostati.
Il servizio è particolarmente utile per eseguire query di indirizzi ambigue in un sistema automatizzato; inoltre, i componenti diversi dall'indirizzo della stringa potrebbero corrispondere ad attività commerciali e indirizzi. Esempi di query di indirizzi ambigui sono gli indirizzi con formattazione scadente o le richieste che includono componenti diversi dall'indirizzo, come i nomi delle attività. Richieste come i primi due esempi nella tabella seguente potrebbero non restituire risultati, a meno che non venga impostata una località, ad esempio una regione, una restrizione di località o un bias di località.
"10 High Street, UK" o "123 Main Street, US" | Diverse "High Street" nel Regno Unito; diverse "Main Street" negli Stati Uniti. La query non restituisce risultati desiderabili a meno che non venga impostata una limitazione di località. |
"ChainRestaurant New York" | Più punti vendita "ChainRestaurant" a New York; nessun indirizzo o nome della via. |
"10 High Street, Escher UK" 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, CA, negli Stati Uniti. |
"UniqueRestaurantName New York" | Solo una struttura con questo nome a New York; non è necessario distinguere la via. |
"pizzerie a Roma" | Questa query contiene la relativa limitazione di località e "pizzerie" è un tipo di luogo ben definito. Restituisce più risultati. |
"+1 514-670-8700" | Questa query contiene un numero di telefono. Restituisce più risultati per i luoghi associati al numero di telefono. |
Explorer API ti consente di effettuare richieste in tempo reale per acquisire familiarità con l'API e le relative opzioni:
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 della 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)
Ricerca testuale (nuovo) restituisce un oggetto JSON come risposta. Nella risposta:
- L'array
places
contiene tutti i luoghi corrispondenti. - Ogni luogo nell'array è rappresentato da un oggetto
Place
. L'oggettoPlace
contiene informazioni dettagliate su un singolo luogo. - La FieldMask passata nella richiesta specifica l'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 una maschera del campo di risposta. Trasmetti la maschera del campo di risposta al metodo utilizzando il parametro URL
$fields
ofields
oppure 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 prassi di progettazione per evitare di richiedere dati non necessari, evitando così tempi di elaborazione e addebiti di fatturazione superflui.
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 nome della risorsa del luogo nel formato:places/PLACE_ID
. Utilizzaplaces.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
eplaces.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.delivery
,places.delivery
,places.delivery
,places.delivery
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 da cercare, ad esempio "ristorante", "123 Main Street" o "il posto migliore da visitare a San Francisco". L'API restituisce le corrispondenze dei candidati in base a 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 dalla Tabella A. È possibile specificare un solo tipo. Ad esempio:
"includedType":"bar"
"includedType":"pharmacy"
languageCode
La lingua in cui restituire i risultati.
- Consulta l'elenco delle lingue supportate. Google aggiorna spesso le lingue supportate, pertanto questo elenco potrebbe non essere esaustivo.
-
Se
languageCode
non viene fornito, l'API predefinita saràen
. Se specifichi un codice lingua non valido, l'API restituisce un erroreINVALID_ARGUMENT
. - L'API fa del suo meglio per fornire un indirizzo che sia leggibile sia per l'utente sia per la gente del posto. Per raggiungere questo obiettivo, restituisce gli indirizzi nella lingua locale, traslitterati in uno script leggibile dall'utente se necessario, osservando la lingua preferita. Tutti gli altri indirizzi vengono restituiti nella lingua preferita. I componenti degli indirizzi vengono restituiti nella stessa lingua, che viene scelta dal primo componente.
- Se un nome non è disponibile nella lingua preferita, l'API utilizza la corrispondenza più simile.
- La lingua preferita ha una piccola influenza sull'insieme di risultati che l'API sceglie di restituire e sull'ordine in cui vengono restituiti. Il geocodificatore interpreta le abbreviazioni in modo diverso a seconda della lingua, ad esempio le abbreviazioni dei tipi di strada o i sinonimi che possono essere validi in una lingua ma non in un'altra.
locationBias
Specifica un'area in cui eseguire la ricerca. Questa località funge da bias, il che significa che possono essere restituiti risultati relativi alla località specificata, compresi quelli al di fuori dell'area specificata.
Puoi specificare
locationRestriction
olocationBias
, ma non entrambi. Pensa alocationRestriction
come a specificare la regione in cui devono trovarsi i risultati, e alocationBias
a a specificare la regione vicina ai risultati, che però possono essere al di fuori dell'area.Specifica la regione come 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 50.000,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 punti bassi e alti opposti diagonalmente. Il punto basso segna l'angolo sud-ovest del rettangolo, mentre il punto alto rappresenta l'angolo nord-est del rettangolo.
Un'area visibile è considerata una regione chiusa, ovvero include il proprio confine. I limiti di latitudine devono essere compresi tra -90 e 90 gradi inclusi, mentre quelli di longitudine devono essere compresi 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 viene invertito (l'area visibile supera la linea di longitudine di 180 gradi). - Se
low.longitude
= -180 gradi ehigh.longitude
= 180 gradi, l'area visibile include tutte le 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 vuota. 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 vengono restituiti. Specifica la regione come un'area visibile rettangolare. Consulta la descrizione di
locationBias
per informazioni sulla definizione dell'area visibile.Puoi specificare
locationRestriction
olocationBias
, ma non entrambi. Pensa alocationRestriction
come a specificare la regione in cui devono trovarsi i risultati, e alocationBias
a a specificare la regione vicina ai risultati, che però possono essere al di fuori dell'area.-
maxResultCount (deprecato)
Specifica il numero di risultati (compreso tra 1 e 20) da visualizzare per pagina. Ad esempio, l'impostazione di un valore
maxResultCount
pari a 5 restituirà fino a 5 risultati nella prima pagina. Se la query può restituire altri risultati, la risposta include un valorenextPageToken
che puoi passare in una richiesta successiva per accedere alla pagina successiva. evOptions
Specifica i parametri per identificare i connettori di ricarica e le velocità di ricarica dei veicoli elettrici (EV) disponibili.
connectorTypes
Filtri in base al tipo di connettore di ricarica EV disponibile in un luogo. Le località che non supportano questi tipi di connettori vengono filtrate. I tipi di connettori di ricarica EV supportati includono caricabatterie combinati (CA e CC), Tesla, caricabatterie conformi a GB/T (per la ricarica rapida EV in Cina) e caricabatterie a muro. Per ulteriori informazioni, consulta la documentazione di riferimento.
minimumChargingRateKw
Filtra i luoghi in base alla velocità di ricarica minima del veicolo elettrico in kilowatt (kW). Tutti i luoghi con una tariffa di ricarica inferiore a quella minima vengono esclusi. Ad esempio, per trovare caricabatterie EV con velocità di ricarica di almeno 10 kW, puoi impostare questo parametro su "10".
minRating
Limita i risultati solo agli utenti con valutazione media degli utenti superiore o uguale a questo limite. I valori devono essere compresi tra 0,0 e 5,0 (incluso) con incrementi di 0,5. Ad esempio: 0, 0,5, 1,0, ... , 5,0 inclusi. I valori vengono arrotondati per eccesso al valore più prossimo allo 0,5. Ad esempio, un valore pari a 0,6 elimina tutti i risultati con una valutazione inferiore a 1,0.
openNow
Se
true
, restituisce solo i luoghi aperti al momento dell'invio della query. Sefalse
, restituisci tutte le attività indipendentemente dallo stato aperto. Se imposti questo parametro sufalse
, vengono restituiti i luoghi che non specificano l'orario di apertura nel database di Google Places.pageSize
Specifica il numero di risultati (compreso tra 1 e 20) da visualizzare per pagina. Ad esempio, l'impostazione di un valore
pageSize
pari a 5 restituirà fino a 5 risultati nella prima pagina. Se la query può restituire altri risultati, la risposta include un valorenextPageToken
che puoi passare in una richiesta successiva per accedere alla pagina successiva.pageToken
Specifica
nextPageToken
nel corpo della risposta della 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 in che modo i risultati vengono classificati nella risposta in base al tipo di query:
- Per una query con categoria come "Ristoranti a New York", il valore predefinito è
RELEVANCE
(classifica i risultati in base alla pertinenza della ricerca). Puoi impostarerankPreference
suRELEVANCE
oDISTANCE
(ranking dei risultati in base alla distanza). - Per una query non categorica come "Mountain View, CA", ti consigliamo
di lasciare
rankPreference
non impostato.
- Per una query con categoria come "Ristoranti a New York", il valore predefinito è
regionCode
Il codice regione utilizzato per formattare la risposta, specificato come valore di codice CLDR a due caratteri. Questo parametro può anche avere un effetto bias sui risultati di ricerca. Non esiste un valore predefinito.
Se il nome del paese del campo
formattedAddress
nella risposta corrisponde aregionCode
, il codice paese viene omesso daformattedAddress
. Questo parametro non ha effetto suadrFormatAddress
, che include sempre il nome del paese, se disponibile, oppure sushortFormattedAddress
, che non lo include mai.La maggior parte dei codici CLDR è identica ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il ccTLD del Regno Unito è "uk" (.co.uk), mentre il codice ISO 3166-1 è"gb " (tecnicamente per l'entità "The United Kingdom of 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
, vengono restituite solo le posizioni che corrispondono ai tipi specificati daincludeType
. Se il valore è false, il valore predefinito è la risposta che può contenere posizioni che non corrispondono ai tipi specificati.
Esempi di ricerca testuale
Trova un luogo tramite la stringa di query
L'esempio seguente mostra una richiesta di ricerca testuale per "Spicy Vegetarian Food in 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 la 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 tipo di ristorante e l'indirizzo web nella
risposta:
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 il campo di dati places.priceLevel
alla risposta in modo che abbia il 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
Utilizza locationRestriction
o locationBias
,
ma non entrambi, per limitare una ricerca a un'area. Pensa a locationRestriction
come a specificare la regione in cui devono trovarsi i risultati e a locationBias
a a specificare la regione vicina ai risultati, che possono essere al di fuori dell'area.
L'esempio seguente mostra una richiesta di ricerca testuale per "Spicy Vegetarian Food" in modo che si trovi entro 500 metri da un punto nel centro di San Francisco. Questa richiesta restituisce solo i primi 10 risultati per i 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
Utilizza minimumChargingRateKw
e connectorTypes
per
cercare luoghi compatibili con il tuo EV con stazioni di ricarica disponibili.
L'esempio seguente mostra una richiesta per i connettori di ricarica EV di tipo 1 Tesla e J1772 con una velocità di ricarica minima di 10 kW a Mountain View, in California. Vengono restituiti solo quattro 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 da restituire per pagina. Il parametro nextPageToken
nel corpo della risposta
fornisce un token che può essere utilizzato nelle chiamate successive per accedere alla pagina successiva dei
risultati.
L'esempio seguente mostra una richiesta per "pizza a New York" limitata a 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 dei risultati, utilizza pageToken
per trasmettere 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 consente di effettuare richieste di esempio, per acquisire familiarità con le opzioni API e API.
Seleziona l'icona dell'API sul lato destro della pagina.
Se vuoi, espandi Mostra parametri standard e imposta il parametro
fields
sulla maschera di campo.Se vuoi, modifica il corpo della richiesta.
Seleziona il pulsante Esegui. Nella finestra di dialogo popup, scegli l'account da utilizzare per effettuare la richiesta.
Nel riquadro Explorer API, seleziona l'icona Espandi, , per espandere la finestra di Explorer API.