Utilisation et facturation de l'API Places

Facturation et tarifs de l'API Places

Pour savoir comment Google calcule votre facturation et vos tarifs, consultez la liste des tarifs de Google Maps Platform ou la liste des tarifs de Google Maps Platform – Inde.

SKU : produit Places (nouvelle version)

Cliquez sur l'icône info info pour afficher le sommaire de cette page. Les sections suivantes décrivent les détails de chaque code SKU:

Catégorie Indique si le SKU appartient à la catégorie SKU Essentials, Pro ou Enterprise.
Événement facturable Événement facturé pour le SKU.
Déclencheurs Éléments de code qui déclenchent des événements facturables
Tarifs Liens vers la grille tarifaire du groupe de SKU.

À propos des masques de champ

Pour Place Details (New), Nearby Search (New) et Text Search (New), utilisez l'en-tête FieldMask dans les requêtes API afin de spécifier la liste des champs à renvoyer dans la réponse. Vous serez ensuite facturé selon le code SKU le plus élevé applicable à votre requête. Par conséquent, si vous sélectionnez des champs à la fois dans les SKU Essentials et Pro, vous serez facturé sur le SKU Pro.

Le masquage de champ est une bonne pratique à appliquer pour vous assurer de ne pas demander de données inutiles. Vous pourrez ainsi réduire le temps de traitement et les frais facturés.

À propos des sessions Autocomplete (nouveau)

Une session Autocomplete (New) inclut une ou plusieurs requêtes Autocomplete (New) et une requête Place Details (New) ou une requête Address Validation. Le même jeton de session est transmis à la requête Autocomplete (New) et à la requête Place Details (New) ou à la requête Address Validation qui s'ensuit.

Une session commence par la première requête Autocomplete (Nouveau). Une requête Place Details (New) ou une requête Address Validation est ensuite envoyée lorsque l'utilisateur a sélectionné l'une des suggestions Autocomplete (New). Si une session est abandonnée, c'est-à-dire qu'aucune requête Place Details (New) ou Validation d'adresse n'est effectuée, les requêtes Autocomplete (New) sont facturées comme si aucun jeton de session n'était fourni.

Une fois qu'un utilisateur a sélectionné un lieu (c'est-à-dire qu'une requête Place Details (New) ou Address Validation est effectuée), vous devez démarrer une nouvelle session à l'aide d'un nouveau jeton.

Un jeton de session ne convient que pour une seule session et ne peut pas être utilisé pour plusieurs sessions. Si vous en réutilisez un, la session est considérée comme non valide, et les requêtes sont facturées comme si aucun jeton n'était fourni.

SKU: Autocomplete Requests

Ce SKU facture les requêtes envoyées à l'API Autocomplete qui n'utilisent pas de session. Pour savoir comment utiliser une session pour limiter le nombre de requêtes facturées au cours d'une session Autocomplete, consultez Jetons de session ou SKU: Utilisation de la session Autocomplete.

  Catégorie Essentials
  Événement facturable Requête
  Déclencheurs

Ce SKU se déclenche dans les cas suivants:

  • Votre requête n'inclut pas de jeton de session.
  • Votre requête inclut un jeton de session, mais vous abandonnez la session.
  • Votre requête inclut un jeton de session, mais vous mettez fin à la session sous certaines conditions. Pour en savoir plus sur l'utilisation des sessions Autocomplete, consultez Jetons de session ou Utilisation des sessions Autocomplete.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: Autocomplete Session Usage

Ce SKU facture chaque requête envoyée à l'API Autocomplete (New) qui inclut un jeton de session.

  Catégorie Essentials
  Événement facturable Requête
  Déclencheurs

Ce SKU est déclenché lorsque vous envoyez une requête à l'API Autocomplete (New) qui inclut un jeton de session.

Ce SKU sert de wrapper pour le SKU des requêtes Autocomplete (New) qui vous permet de limiter le nombre de requêtes facturées au cours d'une seule session Autocomplete. Pour en savoir plus sur l'utilisation des sessions de saisie semi-automatique, consultez Jetons de session.

Remarque:Si vous n'utilisez pas de sessions avec Autocomplete (New), vous êtes facturé par requête de saisie semi-automatique à l'aide du SKU: Autocomplete Requests.

Pour en savoir plus, consultez la section Saisie semi-automatique (nouvelle) et tarifs par session.

  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: API Places Place Details Essentials (IDs Only)

Ce SKU facture les requêtes Place Details qui ne renvoient que l'ID de lieu.

  Catégorie Essentials
  Événement facturable Requête avec les masques de champ spécifiés.
  Déclencheurs

Ce SKU se déclenche lorsque vous demandez les champs suivants:

  • Service Web:
    attributions
    id
    name*
    photos

    * Le champ name inclut le nom de ressource du lieu dans le formulaire: places/PLACE_ID. Utilisez displayName pour accéder au nom textuel du lieu.

  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: API Places Place Details Essentials

Ce SKU facture les requêtes envoyées à l'API Place Details qui récupèrent les champs de ce SKU.
  Catégorie Essentials
  Événement facturable Requête avec les masques de champ spécifiés.
  Déclencheurs

Ce SKU se déclenche lorsque vous demandez les champs d'emplacement suivants:

  • Service Web:
    addressComponents
    adrFormatAddress
    formattedAddress
    location
    plusCode
    shortFormattedAddress
    types
    viewport

  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: API Places Place Details Pro

Ce SKU facture les champs que vous spécifiez dans une requête Place Details Pro.

  Catégorie Pro
  Événement facturable Requête avec les masques de champ spécifiés.
  Déclencheurs Ce SKU se déclenche lorsque votre requête ne concerne que les champs suivants ou des champs de tarif inférieur :
  • Service Web:
    accessibilityOptions
    businessStatus
    containingPlaces
    displayName
    googleMapsLinks*
    googleMapsUri
    iconBackgroundColor
    iconMaskBaseUri
    primaryType
    primaryTypeDisplayName
    pureServiceAreaBusiness
    subDestinations
    utcOffsetMinutes

    * Le champ googleMapsLinks est en phase de pré-disponibilité générale et n'est pas facturé. Autrement dit, la facturation est de 0 $pour l'utilisation pendant la phase de pré-disponibilité générale.

  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: API Places Place Details Enterprise

Ce SKU facture une requête Places incluant des champs Enterprise.

  Catégorie Enterprise
  Événement facturable Requête avec les masques de champ spécifiés.
  Déclencheurs Ce SKU se déclenche lorsque vous demandez les champs suivants :
  • Service Web : currentOpeningHours
    currentSecondaryOpeningHours
    internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    priceRange
    rating
    regularOpeningHours
    regularSecondaryOpeningHours
    userRatingCount
    websiteUri

Si vous mettez fin à une session Autocomplete avec un appel Place Details qui demande n'importe quel champ du SKU: Place Details (Basic, Advanced ou Preferred), l'appel est facturé au tarif du SKU: Place Details (Preferred). Pour en savoir plus, consultez la page SKU: Utilisation de la session de saisie semi-automatique.

  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: API Places Place Details Enterprise + Atmosphere

Ce SKU facture les appels à l'API Place Details qui demandent les champs d'ambiance spécifiés.

  Catégorie Enterprise
  Événement facturable Requête
  Déclencheurs

Ce SKU se déclenche lorsque vous demandez les champs suivants:

  • Service Web:
    allowsDogs
    curbsidePickup
    delivery
    dineIn
    editorialSummary
    evChargeOptions
    fuelOptions
    goodForChildren
    goodForGroups
    goodForWatchingSports
    liveMusic
    menuForChildren
    parkingOptions
    paymentOptions
    outdoorSeating
    reservable
    restroom
    reviews
    routingSummaries*
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine
    takeout

    * Recherche textuelle et Recherche à proximité uniquement

Si une session Autocomplete est arrêtée par un appel Place Details qui demande n'importe quel champ du SKU: Place Details (Basic, Advanced ou Preferred), l'appel est facturé au tarif du SKU: Place Details (Preferred). Pour en savoir plus, consultez la section SKU: Utilisation de la session de saisie semi-automatique.

  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: Places API Nearby Search Pro

Ce SKU facture les champs que vous spécifiez dans une requête Nearby Search Pro.

  Catégorie Pro
  Événement facturable Requête avec les masques de champ spécifiés.
  Déclencheurs Ce SKU se déclenche lorsque votre requête ne concerne que les champs suivants ou des champs de tarif inférieur :
  • Service Web:
    places.accessibilityOptions
    places.addressComponents
    places.adrFormatAddress
    places.attributions
    places.businessStatus
    places.containingPlaces
    places.displayName
    places.formattedAddress
    places.googleMapsLinks*
    places.googleMapsUri
    places.iconBackgroundColor
    places.iconMaskBaseUri
    places.id
    places.location
    places.name**
    places.photos
    places.plusCode
    places.primaryType
    places.primaryTypeDisplayName
    places.pureServiceAreaBusiness
    places.shortFormattedAddress
    places.subDestinations
    places.types
    places.utcOffsetMinutes
    places.viewport

    * Le champ places.googleMapsLinks est en phase de preview avant disponibilité générale. Aucuns frais ne sont facturés, ce qui signifie que la facturation est de 0 $pour l'utilisation pendant la phase de preview.

    ** Le champ places.name inclut le nom de ressource du lieu dans le formulaire: places/PLACE_ID. Utilisez places.displayName pour accéder au nom textuel du lieu.

  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: Places API Nearby Search Enterprise

Ce SKU facture les requêtes Nearby Search qui incluent des champs Enterprise.

  Catégorie Enterprise
  Événement facturable Requête avec les masques de champ spécifiés.
  Déclencheurs

Ce SKU se déclenche lorsque vous demandez les champs suivants:

  • Service Web:
    places.currentOpeningHours
    places.currentSecondaryOpeningHours
    places.internationalPhoneNumber
    places.nationalPhoneNumber
    places.priceLevel
    places.priceRange
    places.rating
    places.regularOpeningHours
    places.regularSecondaryOpeningHours
    places.userRatingCount
    places.websiteUri

  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: API Places Nearby Search Enterprise + Atmosphere

Ce SKU facture les requêtes de recherche dans les environs qui incluent les champs atmostphere spécifiés.

  Catégorie Enterprise
  Événement facturable Requête
  Déclencheurs

Ce SKU se déclenche lorsque vous demandez les champs suivants:

  • Service Web:
    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.routingSummaries*
    places.servesBeer
    places.servesBreakfast
    places.servesBrunch
    places.servesCocktails
    places.servesCoffee
    places.servesDessert
    places.servesDinner
    places.servesLunch
    places.servesVegetarianFood
    places.servesWine
    places.takeout

    * Recherche textuelle et Recherche à proximité uniquement

  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: Places API Text Search Essentials (IDs Only)

Ce code SKU est facturé pour les requêtes à l'API Text Search qui ne renvoient que des ID.
  Catégorie Essentials
  Événement facturable Requête avec les masques de champ spécifiés.
  Déclencheurs

Ce SKU se déclenche lorsque votre requête ne concerne que les champs suivants:

  • Service Web:
    places.attributions
    places.id
    places.name*
    nextPageToken

    * Le champ places.name inclut le nom de ressource du lieu dans le formulaire: places/PLACE_ID. Utilisez places.displayName pour accéder au nom textuel du lieu.

  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: Places API Text Search Pro

Il s'agit d'un SKU Data qui facture les champs que vous spécifiez dans une requête Text Search Pro.
  Catégorie Pro
  Événement facturable Requête avec les masques de champ spécifiés.
  Déclencheurs Ce SKU se déclenche lorsque votre requête ne concerne que les champs suivants ou des champs à tarif inférieur :
  • Service Web:
    places.accessibilityOptions
    places.addressComponents
    places.adrFormatAddress
    places.businessStatus
    places.containingPlaces
    places.displayName
    places.formattedAddress
    places.googleMapsLinks*
    places.googleMapsUri
    places.iconBackgroundColor
    places.iconMaskBaseUri
    places.location
    places.photos
    places.plusCode
    places.primaryType
    places.primaryTypeDisplayName
    places.pureServiceAreaBusiness
    places.shortFormattedAddress
    places.subDestinations
    places.types
    places.utcOffsetMinutes
    places.viewport

    * Le champ places.googleMapsLinks est en phase de prévisualisation avant disponibilité générale. Aucuns frais ne sont facturés, ce qui signifie que la facturation est de 0 $pour l'utilisation pendant la phase de prévisualisation.

  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: Places API Text Search Enterprise

Ce SKU facture les requêtes Text Search qui incluent des champs Enterprise.

  Catégorie Enterprise
  Événement facturable Requête avec les masques de champ spécifiés.
  Déclencheurs Ce SKU se déclenche lorsque vous demandez les champs suivants :
  • Service Web:
    places.currentOpeningHours
    places.currentSecondaryOpeningHours
    places.internationalPhoneNumber
    places.nationalPhoneNumber
    places.priceLevel
    places.priceRange
    places.rating
    places.regularOpeningHours
    places.regularSecondaryOpeningHours
    places.userRatingCount
    places.websiteUri

  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: Places API Text Search Enterprise + Atmosphere

Ce SKU facture les requêtes Text Search qui incluent des champs d'ambiance.

  Catégorie Enterprise
  Événement facturable Requête
  Déclencheurs Ce SKU se déclenche lorsque vous demandez les champs suivants :
  • Service Web:
    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.routingSummaries*
    places.servesBeer
    places.servesBreakfast
    places.servesBrunch
    places.servesCocktails
    places.servesCoffee
    places.servesDessert
    places.servesDinner
    places.servesLunch
    places.servesVegetarianFood
    places.servesWine
    places.takeout

    * Recherche textuelle et Recherche à proximité uniquement

  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: Place Details Photos

Ce SKU facture les requêtes Place Details Photos.

  Catégorie Enterprise
  Événement facturable Requête
  Déclencheurs La facturation est déclenchée lorsque vous demandez une photo à l'API Place Details.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU des anciens produits Places

À propos des sessions Autocomplete

Une session Autocomplete inclut certaines requêtes Autocomplete (pour proposer des suggestions concernant un lieu au fur et à mesure que l'utilisateur effectue sa saisie) et une requête Places Details au maximum (pour récupérer des informations sur le lieu sélectionné par l'utilisateur). Le même jeton de session est transmis à la requête Autocomplete, puis à la requête Places Details qui s'ensuit. Une session commence par la première requête Autocomplete (qui se produit généralement lorsque l'utilisateur commence à saisir du texte). Un appel Places Details a lieu lorsque l'utilisateur a sélectionné l'une des suggestions Autocomplete. Si l'utilisateur ne sélectionne pas de suggestion, aucun appel Places Details n'est effectué.

Une fois qu'un utilisateur a sélectionné un lieu (c'est-à-dire qu'un appel Places Details est effectué), vous devez démarrer une nouvelle session à l'aide d'un nouveau jeton.

Les sessions Autocomplete peuvent être générées à partir des API suivantes :

Un jeton de session ne convient que pour une seule session utilisateur. Si vous en réutilisez un, la session est considérée comme non valide, et les requêtes sont facturées comme si aucun jeton n'avait été fourni.

Les requêtes Autocomplete et Places Details utilisant des sessions sont facturées selon des SKU différents.

À propos des codes SKU Places Data

Les trois SKU Places Data sont Basic Data, Contact Data et Atmosphere Data.

Un ou plusieurs codes SKU Data sont déclenchés pour :

  • Android : chaque requête vers fetchPlace() ou findCurrentPlace()
  • iOS : chaque appel fait à fetchPlaceFromPlaceID: ou findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Service Web : chaque requête Places, en fonction des champs spécifiés dans la requête

Les SKU Data sont toujours facturés en plus du SKU de base pour la requête qui les déclenche. Par exemple, une requête Places Details incluant des champs de données de base sera facturée à la fois sous le SKU Data Basic et sous le SKU Place Details.

Pour le service Web, les requêtes des API Places suivantes vous permettent de spécifier les champs de données à afficher:

Les appels des API Places suivantes NE PERMETTENT PAS de spécifier les champs affichés. Ces appels renvoient toujours toutes les données Places, en facturant les trois SKU Data Places en plus des frais associés à chaque requête API :

Code SKU : Basic Data

Il s'agit d'un SKU Data qui facture les champs de données de base dans une requête Place Details ou Find Place. Ce SKU est facturé en plus du SKU de base pour la requête qui l'a déclenché.

Les champs de la catégorie Basic sont inclus dans le coût de base de la requête Places et n'entraînent aucuns frais supplémentaires.

  Catégorie Essentials
  Événement facturable Requête avec les masques de champ spécifiés.
  Déclencheurs Le SKU Basic Data se déclenche lorsque vous demandez l'un des champs suivants :
  • Android:
    Place.Field.ACCESSIBILITY_OPTIONS
    Place.Field.ADDRESS_COMPONENTS
    Place.Field.BUSINESS_STATUS
    Place.Field.DISPLAY_NAME
    Place.Field.FORMATTED_ADDRESS
    Place.Field.ICON_BACKGROUND_COLOR
    Place.Field.ICON_MASK_URL
    Place.Field.ID
    Place.Field.LOCATION
    Place.Field.PHOTO_METADATAS
    Place.Field.PLUS_CODE
    Place.Field.TYPES
    Place.Field.VIEWPORT
    Place.Field.UTC_OFFSET.
  • iOS:
    GMSPlaceFieldFormattedAddress
    GMSPlaceFieldBusinessStatus
    GMSPlaceFieldID
    GMSPlaceFieldCoordinate
    GMSPlaceFieldName
    GMSPlaceFieldPhotos
    GMSPlaceFieldPlusCode
    GMSPlaceFieldTypes
    GMSPlaceFieldViewport
  • Service Web:
    address_component
    adr_address
    business_status
    formatted_address
    geometry
    icon
    name
    permanently_closed
    photo
    place_id
    plus_code
    type
    url
    utc_offset
    vicinity
    wheelchair_accessible_entrance
  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

Code SKU : Contact Data

Il s'agit d'un code SKU Data qui facture les champs Contact Data dans une requête Places Details ou Find Place. Ce SKU est facturé en plus du SKU de base pour la requête qui l'a déclenché.

Si vous utilisez le paramètre "fields" dans votre requête Places Details ou Find Place pour les services Web, ou un tableau de valeurs Place.Field pour Android ou iOS, vous pouvez limiter la réponse à ces champs spécifiés uniquement. Les champs de la catégorie Contact génèrent des frais supplémentaires.

  Catégorie Enterprise
  Événement facturable Requête avec les masques de champ spécifiés.
  Déclencheurs Le SKU Contact Data se déclenche lorsque l'un des champs suivants est demandé :
  • Android:Place.Field.CURRENT_OPENING_HOURS, Place.Field.INTERNATIONAL_PHONE_NUMBER, Place.Field.OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS ou Place.Field.WEBSITE_URI
  • iOS : GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber ou GMSPlaceFieldWebsite
  • Service Web : formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours ou website
  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

Code SKU : Atmosphere Data

Ce SKU facture les requêtes envoyées à l'API Atmosphere Data qui spécifient les champs de ce SKU.

  Catégorie Enterprise
  Événement facturable Requête avec les masques de champ spécifiés.
  Déclencheurs La facturation est déclenchée lorsque vous demandez l'un des champs suivants :
Android
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.EDITORIAL_SUMMARY
Place.Field.DINE_IN
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.RESERVABLE
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT
Place.Field.USER_RATING_COUNT

iOS

GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood.

JavaScript

Consultez Champs (informations sur le lieu)
curbside_pickup
delivery
dine_in, editorial_summary
price_level
rating
reservable
reviews
serves_beer
serves_breakfast
serves_brunch
serves_dinner
serves_lunch,
serves_vegetarian_food
serves_wine
takeout
user_ratings_total.
  Exemples de facturation avec un masque de champ

Voici des exemples de facturation de la requête en fonction des champs que vous sélectionnez dans le masque de champ.

  • Si le masque de champ de votre requête n'inclut que des champs de ce SKU: la requête est facturée au tarif de ce SKU. Par exemple, vous pouvez demander un ou plusieurs champs de ce SKU et être facturé au tarif de ce SKU.
  • Si le masque de champ de votre requête inclut des champs d'autres SKU: la requête est facturée au tarif SKU le plus élevé pour les champs demandés. Par exemple, si vous incluez des champs de plusieurs SKU, tels qu'un SKU Essentials et un SKU Enterprise, la requête est facturée au tarif du SKU Enterprise.
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU : Autocomplete – Per Request

Ce SKU facture les requêtes qui n'incluent pas de jeton de session.

Si vous envoyez une requête à partir d'une session Autocomplete non valide (par exemple, une session qui réutilise un jeton de session), vous êtes également facturé à hauteur d'un SKU Autocomplete – Per Request.

Les requêtes Autocomplete du widget Place Autocomplete de l'API Maps JavaScript peuvent être facturées à hauteur d'un SKU Autocomplete – Per Request lorsque vous effectuez des requêtes à partir d'une session Autocomplete non valide. Cette situation peut se produire lorsqu'un utilisateur saisit ou copie/colle plusieurs adresses différentes dans le widget, et qu'il ne sélectionne pas toujours la prédiction de saisie semi-automatique.

  Catégorie Essentials
  Événement facturable Requête
  Déclencheurs La facturation est déclenchée pour :
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU : Autocomplete without Place Details – Per Session

Ce SKU est facturé pour une session Autocomplete qui n'inclut pas de requête Place Details (dans les quelques minutes qui suivent le début de la session).

  Catégorie Pro
  Événement facturable Session
  Déclencheurs La facturation est déclenchée si votre application émet les deux requêtes suivantes au cours d'une même session :

Lorsque vous affichez votre facture par SKU, le SKU suivant s'affiche:

  • Autocomplete without Place Details – Per Session
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

Code SKU : Autocomplete (included with Place Details) – Per Session

Les requêtes de saisie semi-automatique sont disponibles sans frais. Ce SKU est facturé lorsque vous demandez des informations sur les lieux supplémentaires en fonction du tarif Places Details standard.

  Catégorie Essentials
  Événement facturable Session
  Déclencheurs Le SKU Autocomplete (included with Place Details) – Per Session est facturé pour chaque session Autocomplete qui inclut l'une des requêtes suivantes :
  • Android : appel fait à fetchPlace()
  • iOS : appel fait à fetchPlaceFromPlaceID:
  • Service Web : requête Places Details

Une requête Places Details génère des SKU Data (Basic, Contact et/ou Atmosphere), en fonction des champs que vous spécifiez dans la requête.

Si vous ne demandez pas de champs spécifiques dans la requête Places Details, tous les SKU Data sont déclenchés (Essentials, Pro, Enterprise et Enterprise + Atmosphere). Spécifiez uniquement les champs dont vous avez besoin pour éviter des frais inutiles.

Si vous ne demandez qu'une actualisation de l'ID Place Details (votre requête ne spécifie que le champ place_id) lors d'une session Autocomplete, la session est facturée comme SKU: Autocomplete without Place Details – Per Session.

  Exemples

Si votre application émet les trois appels suivants au cours d'une même session :

Service Web

Sur votre facture, les SKU suivants sont indiqués (lorsque vous affichez votre facture par SKU) :

  • Autocomplete (included with Place Details) – Per Session
  • Place Details
  • Champs "Basic Data"
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU : Query Autocomplete – Per Request

Cet ancien SKU facture les requêtes de saisie semi-automatique.

  Catégorie Essentials
  Événement facturable Requête
  Déclencheurs

Ce SKU se déclenche lorsque vous envoyez une requête de saisie semi-automatique de requêtes à l'aide des services suivants:

La tarification par session Autocomplete n'est pas compatible avec la requête Query Autocomplete. Les requêtes Places Details qui s'ensuit sont facturées en fonction du SKU Place Details Pro.

  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: Place Details Pro

Ce SKU facture les anciennes requêtes Place Details.

  Catégorie Pro
  Événement facturable Requête
  Déclencheurs La facturation est déclenchée pour les requêtes des API suivantes :

Avec l'API et les services Web, le SKU Place Details est facturé, que vous fournissiez un jeton de session ou non.

Ce SKU déclenche également la facturation des SKU Data: si vous incluez des champs de données dans votre requête, cela peut déclencher une facturation supplémentaire pour les SKU Data: Basic, Contact et Atmosphere. Spécifiez uniquement les champs de données que vous souhaitez afin d'éviter des coûts inutiles. Ce SKU vous est facturé, ainsi que les données que vous demandez.

  Exemples
  1. Effectuez l'un de ces appels ou requêtes :
    • Mobile:appelez fetchPlace() sur Android ou fetchPlaceFromPlaceID: sur iOS, et ne spécifiez que le champ ADDRESS
    • API ou service Web:exécutez une requête Place Details et ne spécifiez que le champ d'adresse: getPlaceDetails(fields: formatted_address)
    Sur votre facture, les SKU suivants sont indiqués (lorsque vous affichez votre facture par SKU) :
    • Place Details
    • Champs "Basic Data"
  2. Effectuez l'un de ces appels ou requêtes :
    • Mobile:appelez fetchPlace() sur Android ou fetchPlaceFromPlaceID: sur iOS, et ne spécifiez que le champ PHONE_NUMBER
    • API ou service Web:exécutez une requête Place Details et spécifiez le champ du numéro de téléphone: getPlaceDetails(fields: formatted_phone_number)
    Sur votre facture, les SKU suivants sont indiqués (lorsque vous affichez votre facture par SKU) :
    • Place Details
    • Contact Data
  3. Effectuez l'un de ces appels ou requêtes :
    • Mobile:appelez fetchPlace() sur Android ou fetchPlaceFromPlaceID: sur iOS, et spécifiez tous les champs
    • API ou service Web:effectuez une requête Places Details et spécifiez tous les champs (ce type de requête est le type par défaut si vous ne spécifiez aucun champ) : getPlaceDetails().
    Sur votre facture, les SKU suivants sont indiqués (lorsque vous affichez votre facture par SKU) :
    • Place Details
    • Champs "Basic Data"
    • Contact Data
    • Atmosphere Data
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU : Place Details – ID Refresh

Ce SKU facture les requêtes envoyées à l'API Place Details qui mettent à jour les ID de lieu non actualisés.

  Catégorie Essentials
  Événement facturable Requête
  Déclencheurs La facturation est déclenchée lorsque vous effectuez une requête Places Details en ne spécifiant que le champ d'identifiant de lieu : getPlaceDetails(fields: place_id).
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU : Find Place

Ce SKU facture les requêtes Find Place qui renvoient plus de champs que l'ID de lieu.

Ce SKU déclenche également la facturation des SKU Data: si vous incluez des champs de données dans votre requête, cela peut déclencher une facturation supplémentaire pour les SKU Data: Basic, Contact et Atmosphere. Spécifiez uniquement les champs de données que vous souhaitez afin d'éviter des coûts inutiles. Ce SKU vous est facturé, ainsi que les données que vous demandez.

  Catégorie Pro
  Événement facturable Requête
  Déclencheurs Ce SKU facture les requêtes envoyées aux méthodes suivantes :
  • Find Current Place

Ce SKU déclenche également la facturation des SKU Data: si vous incluez des champs de données dans votre requête, cela peut déclencher une facturation supplémentaire pour les SKU Data: Basic, Contact et Atmosphere. Spécifiez uniquement les champs de données que vous souhaitez afin d'éviter des coûts inutiles. Ce SKU vous est facturé, ainsi que les données que vous demandez.

  Exemples

Les exemples suivants indiquent les SKU pour lesquels vous êtes facturé lorsque vous effectuez une requête Find Current Place et que vous spécifiez des champs des SKU Data Basic, Contact et Atmosphere. Pour afficher les SKU sur votre facture, affichez-la par SKU, comme décrit dans Analyser l'utilisation et le coût par SKU.

  1. Vous exécutez une requête Find Place et ne spécifiez que le champ d'adresse : FindPlace(fields: formatted_address). Votre facture indique les SKU suivants :
    • Find Place
    • Champs "Basic Data"
  2. Vous exécutez une requête Find Place et spécifiez le champ du numéro de téléphone : FindPlace(fields: formatted_phone_number). Votre facture indique les SKU suivants :
    • Find Place
    • Contact Data
  3. Vous effectuez une requête Find Place et spécifiez des champs provenant des trois buckets de types de données : FindPlace(fields: formatted_address, opening_hours, price_level). Votre facture indique les SKU suivants :
    • Find Place
    • Champs "Basic Data"
    • Contact Data
    • Atmosphere Data
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU : Find Place – ID only

Ce SKU facture les requêtes Find Place qui ne renvoient que l'ID de lieu. Par défaut, si vous ne spécifiez aucun champ dans la requête Find Place, seul l'identifiant de lieu est renvoyé.

  Catégorie Essentials
  Événement facturable Requête
  Déclencheurs Vous effectuez une requête Find Place sans spécifier de champ ou ne spécifiez que le champ place_id: FindPlace(fields: place_id).
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

Code SKU : Places – Nearby Search

Ce SKU facture les requêtes Nearby Search.

  Catégorie Pro
  Événement facturable Requête
  Déclencheurs Ce SKU se déclenche lorsque vous envoyez une requête Nearby Search à l'aide de l'une des API suivantes :

Cette requête ne permet pas de spécifier les champs à renvoyer. La réponse renvoie une liste de lieux et un sous-ensemble des champs de données compatibles.

Ce SKU déclenche également la facturation des SKU Data: si vous incluez des champs de données dans votre requête, cela peut déclencher une facturation supplémentaire pour les SKU Data: Basic, Contact et Atmosphere. Spécifiez uniquement les champs de données que vous souhaitez afin d'éviter des coûts inutiles. Ce SKU vous est facturé, ainsi que les données que vous demandez.

  Exemples

Vous effectuez une requête Nearby Search, par exemple : NearbySearch (San Francisco, 100 meters). Sur votre facture, les SKU suivants sont indiqués lorsque vous affichez votre facture par SKU:

  • Lieu
  • Champs "Basic Data"
  • Contact Data
  • Atmosphere Data
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

Code SKU : Places – Text Search

Ce SKU facture les requêtes adressées au service Places Text Search.

  Catégorie Pro
  Événement facturable Requête
  Déclencheurs La facturation est déclenchée pour les requêtes adressées aux services suivants :

Les requêtes Text Search renvoient une liste de lieux, mais ne permettent pas de spécifier les champs renvoyés. Elles renvoient un sous-ensemble des champs de données compatibles. La requête Text Search vous est facturée, ainsi que pour tous les SKU de type données : Basic Data, Contact Data et Atmosphere Data.

Le SKU Place – Text Search est également déclenché par le widget Places SearchBox de l'API Maps JavaScript: méthode getPlaces() une fois que l'utilisateur a sélectionné une requête de lieu (icône: loupe), pas un résultat (icône: repère), comme illustré ci-dessous:

Places Details Search Box Widget Query Selection
Dans les résultats du widget SearchBox, après avoir saisi "pizza" dans le champ de recherche, vous remarquerez que le texte pizza delivery est précédé d'une icône en forme de loupe, indiquant qu'il s'agit d'une requête de lieu (et non un résultat).
  Exemple

Si vous effectuez une requête Text Search, par exemple TextSearch(123 Main Street), les SKU suivants s'affichent sur votre facture lorsque vous la consultez par SKU:

  • Place – Text Search
  • Champs "Basic Data"
  • Contact Data
  • Atmosphere Data
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

SKU: API Places Place Details Photos

Ce SKU facture l'ancien service Places Photo.

  Catégorie Enterprise
  Événement facturable Requête
  Déclencheurs La facturation est déclenchée pour :
  Tarifs Grille tarifaire principale
Grille tarifaire pour l'Inde

Autres limites d'utilisation

Bien qu'il n'y ait pas de nombre maximal de requêtes par jour, les limites d'utilisation suivantes s'appliquent:

  • API Places (nouvelle version): la limite de débit est de 600 QPM (requêtes par minute) par méthode d'API et par projet. Cela signifie que chaque méthode d'API dispose d'un quota distinct.

  • API Places: la limite de débit est de 6 000 RPM (requêtes par minute). Il est calculé comme la somme des requêtes côté client et côté serveur pour toutes les applications utilisant les identifiants du même projet.

Restrictions liées aux conditions d'utilisation

Pour en savoir plus sur les conditions d'utilisation, consultez les Règles de l'API Places et la section Restrictions liées aux licences des conditions d'utilisation de Google Maps Platform.