Ricerca testo (Novità)

Seleziona la piattaforma: Android iOS JavaScript Servizio web

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:

Prova!

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'oggetto Place 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 o fields oppure tramite l'intestazione HTTP X-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 campo places.name contiene il luogo nome risorsa nel formato: places/PLACE_ID. Usa places.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 predefinita en. Se specifichi un codice lingua non valido, l'API restituisce un errore INVALID_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 o locationBias, ma non entrambi. Considera locationRestriction come una specifica regione in cui devono essere contenuti i risultati e locationBias 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 e high.longitude = 180 gradi, l'area visibile include tutti longitudini.
      • Se low.longitude = 180 gradi e high.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
    }
  }
}

  • 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 o locationBias, ma non entrambi. Considera locationRestriction come una specifica regione in cui devono essere contenuti i risultati e locationBias 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 un nextPageToken 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. Se false, 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 su false.

  • 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 un nextPageToken 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 impostare rankPreference su RELEVANCE oppure DISTANCE (ranking dei risultati in base alla distanza).
    • Per una query non categorica come "Mountain View, CA", ti consigliamo devi lasciare rankPreference non impostato.

  • 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 a regionCode, il codice paese viene omesso da formattedAddress. Questo parametro non ha alcun effetto su adrFormatAddress, che include sempre il paese quando è disponibile oppure su shortFormattedAddress, 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 su true, solo le località che corrispondono ai tipi specificati specificati da Vengono restituiti includeType. 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.

  1. Seleziona l'icona dell'API Espandi Explorer API.. sul lato destro della pagina.

  2. Se vuoi, espandi Mostra parametri standard e imposta il fields parametro al campo maschera.

  3. Se vuoi, modifica il corpo della richiesta.

  4. Seleziona il pulsante Esegui. Nella finestra di dialogo popup, scegli l'account con da utilizzare per effettuare la richiesta.

  5. Nel riquadro Explorer API, seleziona l'icona Espandi, Espandi Explorer API., per espandere la finestra Explorer API.