Text Search (nouvelle version)

Sélectionnez une plate-forme : Android iOS JavaScript Services Web

Text Search (nouvelle version) renvoie des informations sur un ensemble de lieux en fonction d'une chaîne. Par exemple : "pizza à New York" ou "magasins de chaussures près d'Ottawa" ou "123 Main Street". La Le service renvoie une liste de lieux correspondant à la chaîne de texte et aux emplacements le biais qui a été défini.

Le service est particulièrement utile pour faire les requêtes d'adresse ambiguës dans un système automatisé, et les composants de la chaîne ne correspondant pas à des adresses peuvent correspondre d’entreprises et d’adresses. Voici quelques exemples de requêtes d'adresse ambiguës : des adresses mal formatées ou des requêtes incluant des composants autres que des adresses, tels que en tant que noms d'entreprise. Les requêtes semblables aux deux premiers exemples du tableau suivant peut ne renvoyer aucun résultat, sauf si un lieu (comme une région ou un emplacement) une restriction ou un biais de localisation) est défini.

"10 High Street, UK" ou "123 Main Street, US" Plusieurs boutiques de "High Street" au Royaume-Uni plusieurs "Main Street" aux États-Unis. La requête ne renvoie pas de résultats souhaitables, sauf si une restriction d'emplacement est défini.
"ChainRestaurant New York" Plusieurs "ChainRestaurant" à New York ; sans adresse postale et même le nom de la rue.
"10 High Street, Escher Royaume-Uni" ou "123 Main Street, Pleasanton US" Une seule "High Street" dans la ville d'Escher au Royaume-Uni, une seule "Rue principale" dans la ville américaine de Pleasanton, en Californie.
"UniqueRestaurantName New York" Un seul établissement portant ce nom à Paris aucune adresse postale nécessaires pour différencier.
"restaurants pizzerias à Paris" Cette requête contient la restriction géographique associée, ainsi que les termes "pizzas" correspond à d'un type de lieu bien défini. Elle renvoie plusieurs résultats.
"+1 514-670-8700"

Cette requête contient un numéro de téléphone. Elle renvoie plusieurs résultats pour lieux associés à ce numéro de téléphone.

APIs Explorer vous permet d'effectuer des requêtes en direct afin que vous puissiez vous familiariser avec l'API et la Options d'API:

Essayer

Requêtes Text Search

Une requête Text Search est une requête HTTP POST au format suivant:

https://places.googleapis.com/v1/places:searchText

Transmettez tous les paramètres dans le corps de la requête JSON ou dans les en-têtes dans le cadre de la méthode requête POST. Exemple :

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'

Réponses de Text Search (nouvelle version)

Text Search (nouvelle version) renvoie une JSON comme réponse. Dans la réponse :

  • Le tableau places contient tous les lieux correspondants.
  • Chaque lieu du tableau est représenté par un Place . L'objet Place contient des informations détaillées sur un seul à un emplacement.
  • Le champ FieldMask transmis dans la requête spécifie la Liste des champs renvoyés dans l'objet Place.

L'objet JSON complet se présente sous la forme suivante:

{
  "places": [
    {
      object (Place)
    }
  ]
}

Paramètres obligatoires

  • FieldMask

    Spécifiez la liste des champs à renvoyer dans la réponse en créant un masque de champ de réponse. Transmettre le masque de champ de réponse à la méthode à l'aide du paramètre d'URL $fields ou fields, ou à l'aide de l'en-tête HTTP X-Goog-FieldMask Il n'existe pas de liste par défaut des champs renvoyés dans la réponse. Si vous omettez le masque de champ, la méthode renvoie une erreur.

    Le masquage du champ est une bonne pratique de conception pour vous assurer que vous ne demandez pas des données inutiles, ce qui permet d'éviter les délais de traitement et frais facturés.

    Spécifiez une liste de types de données de lieu à renvoyer, séparés par une virgule. Par exemple : pour récupérer le nom à afficher et l'adresse du lieu.

    X-Goog-FieldMask: places.displayName,places.formattedAddress

    Utilisez * pour récupérer tous les champs.

    X-Goog-FieldMask: *

    Renseignez un ou plusieurs des champs suivants:

    • Les champs suivants déclenchent le SKU Text Search (ID Only):

      places.attributions, places.id, places.name*, nextPageToken

      * Le champ places.name contient le nom de ressource du lieu. au format suivant: places/PLACE_ID. Utilisez places.displayName pour accéder au nom textuel du lieu.

    • Les champs suivants déclenchent le SKU Text Search (Basic):

      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

    • Les champs suivants déclenchent le SKU Text Search (Advanced):

      places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

    • Les champs suivants déclenchent le SKU Text Search (Preferred):

      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

    Chaîne de texte sur laquelle doit porter la recherche, par exemple : "restaurant", "123 Main Street" ou "meilleur endroit à visiter à San Francisco". L'API renvoie des correspondances de candidats en fonction sur cette chaîne et ordonne les résultats en fonction de leur pertinence estimée.

Paramètres facultatifs

  • includedType

    Limite les résultats aux lieux correspondant au type spécifié défini par Tableau A : Vous ne pouvez spécifier qu'un seul type. Exemple :

    • "includedType":"bar"
    • "includedType":"pharmacy"

  • languageCode

    Langue dans laquelle les résultats doivent être renvoyés.

    • Consultez le liste des langues acceptées Google met souvent à jour les langues acceptées. Il est donc possible que cette liste ne soit pas exhaustif.
    • Si languageCode n'est pas fourni, l'API utilise par défaut la valeur en Si vous spécifiez un code de langue non valide, l'API renvoie une erreur INVALID_ARGUMENT.
    • L'API s'efforce de fournir une adresse postale lisible par à la fois l’utilisateur et les locaux. Pour atteindre cet objectif, la fonction dans la langue locale, transcrites en un script lisible par l'utilisateur si nécessaire, en tenant compte de la langue préférée. Toutes les autres sont renvoyées dans la langue de votre choix. Les composants d'adresse sont tous renvoyés dans la même langue, celle choisie .
    • Si un nom n'est pas disponible dans la langue préférée, l'API utilise le la correspondance la plus proche.
    • La langue préférée a une petite influence sur l'ensemble des résultats l'API choisit de les renvoyer, ainsi que l'ordre dans lequel ils sont renvoyés. La le geocoder interprète les abréviations différemment selon la langue, comme les abréviations de types de rues ou des synonymes est valide dans une langue, mais pas dans une autre.

  • locationBias

    Spécifie une zone de recherche. Cet emplacement sert de biais, ce qui signifie des résultats situés à proximité du lieu spécifié, y compris des résultats en dehors de la zone spécifiée.

    Vous pouvez spécifier locationRestriction ou locationBias, mais pas les deux. Considérez locationRestriction comme une spécification dans la région dans laquelle doivent se trouver les résultats, et locationBias en tant que spécifiant la région dont les résultats doivent être proches, mais qui peuvent se trouver en dehors de la zone.

    Spécifiez la région sous forme de fenêtre d'affichage rectangulaire ou de cercle.

    • Un cercle est défini par le point central et le rayon en mètres. Le rayon doit être comprise entre 0.0 et 50000.0, inclus. Le rayon par défaut est de 0,0. Exemple :

      "locationBias": {
  "circle": {
    "center": {
      "latitude": 37.7937,
      "longitude": -122.3965
    },
    "radius": 500.0
  }
}

    • Un rectangle est une fenêtre d'affichage de latitude-longitude, représentée par deux en diagonale à l'opposé des points haut et bas. Le point bas indique le sud-ouest. du rectangle et le point haut représente le nord-est du rectangle.

      Une fenêtre d'affichage est considérée comme fermée, ce qui signifie qu'elle inclut ses limites. Les limites de latitude doit être comprise entre -90 et 90 degrés inclus, et les limites de longitude doit être comprise entre -180 et 180 degrés inclus:

      • Si low = high, la fenêtre d'affichage est constituée des éléments suivants : sur ce point.
      • Si low.longitude > high.longitude, le de longitude est inversée (la fenêtre d'affichage traverse (ligne de longitude).
      • Si low.longitude = -180 degrés et high.longitude = 180 degrés, la fenêtre d'affichage inclut tous les et des longitudes.
      • Si low.longitude = 180 degrés et high.longitude = -180 degrés, la plage de longitude est vide.
      • Si low.latitude > high.latitude, le La plage de latitude est vide.

      Les valeurs "Faible" et "Élevée" doivent être renseignées, et la boîte représentée ne peut pas être vide. Une fenêtre d'affichage vide entraîne une erreur.

      Par exemple, cette fenêtre d'affichage englobe entièrement New York:

      "locationBias": {
  "rectangle": {
    "low": {
      "latitude": 40.477398,
      "longitude": -74.259087
    },
    "high": {
      "latitude": 40.91618,
      "longitude": -73.70018
    }
  }
}

  • locationRestriction

    Spécifie une zone de recherche. Les résultats situés en dehors de la zone spécifiée renvoyé. Spécifiez la région sous la forme d'une fenêtre d'affichage rectangulaire. Voir la description sur locationBias pour en savoir plus sur la définition de la fenêtre d'affichage.

    Vous pouvez spécifier locationRestriction ou locationBias, mais pas les deux. Considérez locationRestriction comme une spécification dans la région dans laquelle doivent se trouver les résultats, et locationBias en tant que spécifiant la région dont les résultats doivent être proches, mais qui peuvent se trouver en dehors de la zone.

  • maxResultCount (obsolète)

    Spécifie le nombre de résultats (entre 1 et 20) à afficher par page. Par exemple, si vous définissez une valeur maxResultCount de 5, vous obtiendrez jusqu'à 5 sur la première page. Si d'autres résultats peuvent être renvoyés de la requête, la réponse inclut un nextPageToken que vous peut être transmis dans une requête ultérieure pour accéder à la page suivante.

  • evOptions

    Spécifie les paramètres permettant d'identifier les véhicules électriques (VE) disponibles connecteurs et vitesses de charge.

    • connectorTypes

      Filtre en fonction du type de connecteur de recharge de VE disponible à un endroit. A un emplacement n'acceptant aucun type de connecteur sera filtré s'affiche. Les types de connecteurs de recharge de VE compatibles incluent les types de bornes de recharge combinées (CA et CC) chargeurs, chargeurs Tesla, chargeurs conformes à la norme GB/T (pour la recharge rapide VE (Chine) et les chargeurs de prise murale. Pour en savoir plus, consultez la documentation de référence dans la documentation Google Cloud.

    • minimumChargingRateKw

      Filtre les lieux en fonction de la vitesse de recharge minimale du VE en kilowatts (kW). N'importe quelle valeur les emplacements dont le taux de facturation est inférieur au taux minimal sont filtrées. Par exemple, pour trouver les bornes de recharge de VE dont la vitesse de recharge 10 kW au minimum, vous pouvez définir ce paramètre sur "10".

  • minRating

    Limite les résultats aux seuls utilisateurs dont la note moyenne par les utilisateurs est supérieure à ou égale à cette limite. Les valeurs doivent être comprises entre 0.0 et 5.0 (inclus) dans par incréments de 0,5. Par exemple: 0, 0,5, 1.0, ... , 5.0 (inclus). Les valeurs sont les suivantes : arrondie au 0,5 le plus proche. Par exemple, une valeur de 0,6 élimine tous résultats avec une note inférieure à 1,0.

  • openNow

    Si la valeur est true, ne renvoyez que les lieux ouverts lors de l'envoi de la requête. Si la valeur est false, renvoie tous les établissements quel que soit leur état d'ouverture. Les lieux pour lesquels aucun horaire d'ouverture n'est spécifié dans la base de données Google Places sont est renvoyé si vous définissez ce paramètre sur false.

  • pageSize

    Spécifie le nombre de résultats (entre 1 et 20) à afficher par page. Par exemple, si vous définissez une valeur pageSize de 5, vous obtiendrez jusqu'à 5 sur la première page. Si d'autres résultats peuvent être renvoyés de la requête, la réponse inclut un nextPageToken que vous peut être transmis dans une requête ultérieure pour accéder à la page suivante.

  • pageToken

    Spécifie le nextPageToken à partir du corps de réponse de la page précédente.

  • priceLevels

    Limitez la recherche aux lieux pour lesquels des prix s'appliquent. Par défaut, tous les niveaux de prix sont sélectionnés.

    Spécifiez un tableau contenant une ou plusieurs valeurs définies par PriceLevel

    Exemple :

    "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]

  • rankPreference

    Spécifie la façon dont les résultats sont classés dans la réponse en fonction du type de requête:

    • Pour une requête catégorielle telle que "Restaurants à New York", RELEVANCE (classer les résultats en fonction de la pertinence des recherches) est l'option par défaut. Vous pouvez définir rankPreference sur RELEVANCE ou DISTANCE (classer les résultats en fonction de la distance)
    • Pour une requête non catégorielle telle que "Mountain View, CA", nous recommandons de ne pas définir rankPreference.

  • regionCode

    Code régional utilisé pour mettre en forme la réponse, spécifié sous la forme d'une CLDR à deux caractères. Ce paramètre peut aussi avoir un effet de biais dans les résultats de recherche. Il n'existe pas de valeur par défaut.

    Si le nom du pays indiqué dans le champ formattedAddress dans le correspond à regionCode, le code pays est omis de formattedAddress. Ce paramètre n'a aucun effet sur adrFormatAddress, qui inclut toujours le pays ou sur shortFormattedAddress, qui n'est jamais associé l'inclut.

    La plupart des codes CLDR sont identiques aux codes ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD au Royaume-Uni est "uk" (.co.uk), tandis que son code ISO 3166-1 est "gb". (d'un point de vue technique, du Royaume-Uni de Grande-Bretagne et d'Irlande du Nord). Ce paramètre peut avoir un impact sur les résultats en fonction du droit applicable.

  • strictTypeFiltering

    Utilisé avec le paramètre includedType. Si défini sur true, uniquement les lieux correspondant aux types spécifiés par Les includeType sont renvoyés. Si la valeur est "false", la réponse par défaut peut contenir des lieux qui ne correspondent pas les types spécifiés.

Exemples de Text Search

Trouver un lieu par chaîne de requête

L'exemple suivant illustre une requête Text Search pour "Nourriture végétarienne épicée à Sydney, Australie" :

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'

Notez que l'en-tête X-Goog-FieldMask indique que réponse contient les champs de données suivants: places.displayName,places.formattedAddress. La réponse se présente alors sous la forme suivante:

{
  "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"
      }
    },
    ...
  ]
}

Ajoutez d'autres types de données au masque de champ pour renvoyer des informations supplémentaires. Par exemple, ajoutez places.types,places.websiteUri pour inclure le le type de restaurant et l'adresse Web réponse:

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 réponse se présente désormais sous la forme suivante:

{
  "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"
      }
    },
    ...
  ]
}

Filtrer les lieux par niveau de prix

Utilisez l'option priceLevel pour filtrer les résultats en fonction des restaurants défini comme peu coûteux ou modérément cher:

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'

Cet exemple utilise également l'en-tête X-Goog-FieldMask pour ajouter le places.priceLevel au champ de données réponse pour qu'elle se présente sous la forme suivante:

{
  "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"
      }
    },
    ...
  ]
}

Ajoutez des options supplémentaires pour affiner votre recherche, par exemple includedType, minRating, rankPreference, openNow et d'autres paramètres décrits dans la section Paramètres facultatifs.

Rechercher des lieux dans une zone

Utilisez locationRestriction ou locationBias, mais pas les deux, pour limiter une recherche à une zone. Pensez à locationRestriction comme spécifier la région dans laquelle doivent se trouver les résultats ; et locationBias comme spécifier la région dont les résultats doivent être proches, mais qui peuvent se trouver en dehors de la zone.

L'exemple suivant illustre une requête Text Search pour "Nourriture végétarienne épicée" biaisée à 500 mètres maximum d'un point dans le centre-ville de San Francisco. Cette requête ne renvoie que les 10 premiers résultats pour les lieux ouverts.

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'

Rechercher des bornes de recharge de VE avec une vitesse de recharge minimale

Utilisez minimumChargingRateKw et connectorTypes pour recherchez des lieux disposant de bornes de recharge compatibles avec votre VE.

L'exemple suivant présente une demande de recharge de VE de type 1 à Tesla et à J1772 avec une puissance de recharge minimale de 10 kW à Mountain View, en Californie. Seulement quatre sont renvoyés.

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 requête renvoie la réponse suivante:

{
  "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
          }
        ]
      }
    }
  ]
}

Spécifiez un nombre de résultats à renvoyer par page

Utilisez le paramètre pageSize pour spécifier le nombre de résultats à par page. Paramètre nextPageToken dans le corps de la réponse fournit un jeton qui peut être utilisé dans les appels suivants pour accéder à la page suivante de résultats.

L'exemple suivant illustre une requête pour une "pizza à New York". limité à 5 résultats par page:

 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"
}

Pour accéder à la page de résultats suivante, utilisez pageToken pour transmettre la nextPageToken dans le corps de la requête:

 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"
}

Essayer

APIs Explorer vous permet de créer des exemples de requêtes afin de vous familiariser avec l'API et ses options.

  1. Sélectionnez l'icône API Développez APIs Explorer., sur le côté droit de la page.

  2. Vous pouvez également développer Afficher les paramètres standards et définir fields par le champ masque.

  3. Vous pouvez également modifier le corps de la requête.

  4. Sélectionnez le bouton Execute (Exécuter). Dans la boîte de dialogue pop-up, sélectionnez le compte que vous souhaitez utiliser pour effectuer la requête.

  5. Dans le panneau APIs Explorer, sélectionnez l'icône de développement, Développez APIs Explorer., pour développer la fenêtre de l'explorateur d'API.