Una ricerca testuale (nuova) restituisce informazioni su un insieme di luoghi in base a una stringa, ad esempio "pizza a New York", "negozi di scarpe vicino a Ottawa" o "123 Main Street". Il servizio risponde con un elenco di posizioni corrispondenti alla stringa di testo e a eventuali bias di località impostati.
Il servizio è particolarmente utile per creare query ambigue sugli indirizzi in un sistema automatico e i componenti diversi dall'indirizzo della stringa potrebbero corrispondere alle attività commerciali e agli indirizzi. Esempi di query ambigue sull'indirizzo sono indirizzi con formattazione scadente o richieste che includono componenti diversi dall'indirizzo come nomi delle attività. Le richieste come i primi due esempi nella tabella seguente potrebbero restituire zero risultati a meno che non sia impostata una località, ad esempio regione, restrizione di località o bias per località.
"10 High Street, UK" o "123 Main Street, US" | Diverse "High Street" nel Regno Unito e diverse "Main Street" negli Stati Uniti. La query non restituisce risultati desiderabili, a meno che non sia impostata una limitazione di località. |
"ChainRestaurant New York" | Diverse sedi "ChainRestaurant" a New York; nessun indirizzo né nome della via. |
"Via Roma 12, Fiumicino Italia" o "Via Roma 12, Milano" | Solo una "High Street" nella città britannica di Escher; solo una "Main Street" nella città statunitense di Pleasanton CA. |
"Nomeristorante unico di New York" | Solo un'attività con questo nome a New York; non è necessario distinguere tra una via e l'altra. |
"pizzeria a Roma" | Questa query contiene la sua limitazione di località e "pizzeria" è 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 in questione. |
Explorer API ti consente di effettuare richieste in tempo reale in modo da acquisire familiarità con l'API e le relative opzioni:
Richieste di ricerca testuale
Una richiesta di ricerca testuale è una richiesta HTTP POST del 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'
Ricerca testuale (nuove) risposte
Text Search (New) restituisce un oggetto JSON come risposta. Nella risposta:
- L'array
places
contiene tutte le posizioni corrispondenti. - Ogni posizione nell'array è rappresentata da un oggetto
Place
. L'oggettoPlace
contiene informazioni dettagliate su una singola posizione. - Il valore FieldMask passato 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 della risposta. Passa la maschera del campo della risposta al metodo utilizzando il parametro URL
$fields
ofields
oppure l'intestazione HTTPX-Goog-FieldMask
. Nella risposta non è presente un elenco predefinito di campi restituiti. Se ometti la maschera del campo, il metodo restituisce un errore.Il mascheramento dei campi è una buona pratica di progettazione per garantire di non richiedere dati non necessari, il che contribuisce a evitare tempi di elaborazione e addebiti di fatturazione superflui.
Specifica un elenco separato da virgole di tipi di dati sui 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 di ricerca di testo (solo ID):
places.id
,places.name
*
* Il campoplaces.name
contiene il luogo nome risorsa nel formato:places/PLACE_ID
. Utilizzaplaces.displayName
per accedere al nome testuale del luogo.I seguenti campi attivano lo SKU di Ricerca testuale (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 di 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 di 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.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDesserts
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
-
textQuery
La stringa di testo in cui cercare, ad esempio: "ristorante", "Via Roma 123" o "luogo migliore da visitare a San Francisco". L'API restituisce le corrispondenze candidati in base a questa stringa e ordina i risultati in base alla pertinenza percepita.
Parametri facoltativi
includedType
Limita i risultati ai luoghi 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, il valore predefinito dell'API 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 che per i residenti. Per raggiungere questo obiettivo, restituisce gli indirizzi nella lingua locale, traslitte in uno script leggibile dall'utente se necessario, osservando la lingua preferita. Tutti gli altri indirizzi vengono restituiti nella lingua preferita. I componenti dell'indirizzo vengono tutti restituiti nella stessa lingua, che viene scelta dal primo componente.
- Se un nome non è disponibile nella lingua preferita, l'API utilizza la corrispondenza più vicina.
- 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 per i tipi di strada o i sinonimi che possono essere validi in una lingua, ma non in un'altra.
locationBias
Specifica un'area da cercare. Questa località funge da bias, il che significa che possono essere restituiti i risultati relativi alla località specificata, inclusi i risultati 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, mentrelocationBias
a specifica la regione in cui i risultati devono essere vicini, ma che possono essere al di fuori dell'area.Specifica l'area come un'area visibile rettangolare o come un cerchio.
Un cerchio viene definito dal punto centrale 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 diagonali opposti al punto più basso e al punto più alto. Il punto più basso segna l'angolo sud-ovest del rettangolo, mentre il punto più alto rappresenta l'angolo nord-est del rettangolo.
Un'area visibile è considerata una regione chiusa, ovvero include i suoi confini. I limiti di latitudine devono essere compresi tra -90 e 90 gradi inclusi, mentre i limiti 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 attraversa 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 compilate entrambe le opzioni, mentre 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 da cercare. 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 su come definire l'area visibile.Puoi specificare
locationRestriction
olocationBias
, ma non entrambi. Pensa alocationRestriction
come a specificare la regione in cui devono trovarsi i risultati, mentrelocationBias
a specifica la regione in cui i risultati devono essere vicini, ma che possono essere al di fuori dell'area.-
maxResultCount (deprecato)
Specifica il numero di risultati (compreso tra 1 e 20) da visualizzare per ogni 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 più risultati, la risposta include un valorenextPageToken
che puoi passare in una richiesta successiva di accesso alla pagina successiva. evOptions
Specifica i parametri per identificare i connettori di ricarica dei veicoli elettrici (EV) disponibili e le velocità di ricarica.
connectorTypes
Filtri per tipo di connettore di ricarica EV disponibile in un luogo. Una posizione che non supporta nessuno di questi tipi di connettore verrà filtrata. I tipi di connettori di ricarica EV supportati includono caricabatterie combinati (CA e CC), caricabatterie Tesla, caricabatterie conformi a GB/T (per la ricarica rapida EV in Cina) e caricabatterie per prese a muro. Per ulteriori informazioni, consulta la documentazione di riferimento.
minimumChargingRateKw
Filtra i luoghi in base alla velocità di ricarica minima del EV in kilowatt (kW). Tutti i luoghi con una tariffa 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 a quelli la cui valutazione media degli utenti è superiore o uguale a questo limite. I valori devono essere compresi tra 0,0 e 5,0 (inclusi) con incrementi di 0,5. Ad esempio: 0, 0,5, 1,0, ..., 5,0 inclusi. I valori vengono arrotondati per eccesso allo 0,5 più vicino. Ad esempio, un valore pari a 0,6 elimina tutti i risultati con una valutazione inferiore a 1,0.
openNow
Se
true
, restituisci solo i luoghi aperti all'attività al momento dell'invio della query. Sefalse
, restituisci tutte le attività indipendentemente dallo stato aperto. I luoghi che non specificano l'orario di apertura nel database di Google Places vengono restituiti se imposti questo parametro sufalse
.pageSize
Specifica il numero di risultati (compreso tra 1 e 20) da visualizzare per ogni 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 più risultati, la risposta include un valorenextPageToken
che puoi passare in una richiesta successiva di accesso alla pagina successiva.pageToken
Specifica
nextPageToken
dal corpo della risposta della pagina precedente.-
priceLevels
Limita 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 di categoria come "Ristoranti a New York", l'impostazione predefinita è
RELEVANCE
(classifica i risultati in base alla pertinenza della ricerca). Puoi impostarerankPreference
suRELEVANCE
oDISTANCE
(classifica i risultati in base alla distanza). - Per una query non categoriale come "Mountain View, CA", ti consigliamo
di non impostare
rankPreference
.
- Per una query di categoria come "Ristoranti a New York", l'impostazione predefinita è
regionCode
Il codice regione utilizzato per formattare la risposta, specificato come valore del codice CLDR a due caratteri. Questo parametro può anche avere un effetto di bias sui risultati di ricerca. Non è presente alcun valore predefinito.
Se il nome del paese nel 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, o 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à "Regno Unito di Gran Bretagna e Irlanda del Nord"). Il parametro può influire sui risultati in base alla legge vigente.
strictTypeFiltering
Da utilizzare con il parametro
includeType
. Se impostato sutrue
, vengono restituiti solo i luoghi che corrispondono ai tipi specificati specificati daincludeType
. Quando il valore è false, per impostazione predefinita la risposta può contenere luoghi 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 "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 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 abbastanza 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 dati places.priceLevel
alla risposta, in modo che sia nel 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 nella sezione
Parametri facoltativi.
Cercare luoghi in una zona
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
come a specificare la regione in cui i risultati devono essere vicini, ma che possono essere al di fuori dell'area.
L'esempio seguente mostra una richiesta di ricerca testuale per "Cibo vegetariano piccante" che tende a non superare i 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 caricabatterie EV con una velocità di ricarica minima
Usa minimumChargingRateKw
e connectorTypes
per
cercare luoghi con caricabatterie disponibili compatibili con il tuo EV.
L'esempio seguente mostra una richiesta di connettori di ricarica EV Tesla e J1772 di tipo 1 con una velocità di ricarica minima di 10 kW a Mountain View, CA. 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 il numero di risultati da restituire per ogni pagina
Utilizza il parametro pageSize
per specificare un numero di risultati da restituire per ogni pagina. Il parametro nextPageToken
nel corpo della risposta fornisce un token che può essere utilizzato nelle chiamate successive per accedere alla pagina dei risultati successiva.
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 dei risultati successiva, utilizza pageToken
per trasmettere l'elemento
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 in modo da 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.(Facoltativo) 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 di espansione, , per espandere la finestra Explorer API.