Facturation de l'API Places
Les API Places (nouvelle version) et Places utilisent un modèle de paiement à l'usage. Les API et les SDK Google Maps Platform sont facturés en fonction du SKU. L'utilisation est suivie pour chaque SKU, et chaque API ou SDK peut être associé à plusieurs SKU de produits. Le coût est calculé comme suit:
Utilisez notre simulateur de prix et d'utilisation pour estimer votre coût d'utilisation par API ou SDK. Un crédit Google Maps Platform de 200 $ est disponible pour chaque compte de facturation pour les SKU Google Maps Platform éligibles. Ce crédit est automatiquement appliqué aux SKU éligibles.
Tarifs de l'API Places (nouvelle version)
À 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 "(Basic)" et "(Advanced)", vous serez facturé sur le SKU "(Advanced)".
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 de saisie semi-automatique (nouvelle version)
Une session Autocomplete (New) inclut une ou plusieurs requêtes Autocomplete (New), ainsi qu'une requête Place Details (New) ou Address Validation. Le même jeton de session est transmis à la requête Autocomplete (New) et à la requête Place Details (New) suivante ou à la requête Address Validation.
Une session commence par la première requête Autocomplete (New). Une requête Place Details (New) ou Address Validation est ensuite envoyée lorsque l'utilisateur a sélectionné l'une des suggestions Autocomplete (New). Si une session est abandonnée, ce qui signifie qu'aucune requête Place Details (New) ni aucune requête Address Validation 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 a été effectuée), vous devez démarrer une nouvelle session à l'aide d'un nouveau jeton.
Un jeton de session convient pour une 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'avait été fourni.
SKU: Requêtes Autocomplete
Un SKU Requêtes Autocomplete est facturé pour chaque requête envoyée à l'API Autocomplete (nouvelle) qui n'inclut pas de jeton de session.
Elle est également facturée si vous utilisez des jetons de session et:
- Mettez fin aux sessions en envoyant une seule requête à Place Details (New) qui demande tous les champs définis par le SKU: Place Details (Location Only).
- Chaque requête Autocomplete (New), jusqu'à 12 requêtes, est facturée selon le SKU: requêtes Autocomplete.
- Chaque requête Autocomplete (New) ultérieure est facturée selon le SKU: Autocomplete Session Usage.
- Quittez la session ou mettez-y fin en appelant le SKU: Place Details (IDs Only). Toutes les requêtes Autocomplete (New) sont ensuite facturées à l'aide du SKU: requêtes Autocomplete.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,00283 USD prix unitaire (2,83 USD pour 1 000) |
0,00227 USD prix unitaire (2,27 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
SKU: Autocomplete Session Usage
Un SKU Autocomplete Session Usage (Utilisation de session Autocomplete) est facturé pour chaque requête envoyée à l'API Autocomplete (nouvelle) incluant un jeton de session.
Ce SKU est facturé dans les cas suivants:
Session de saisie semi-automatique interrompue par un appel à SKU: Place Details (Location Only):
- Chaque requête Autocomplete (New), jusqu'à 12 requêtes, est facturée selon le SKU: requêtes Autocomplete.
- Chaque requête Autocomplete (New) ultérieure est facturée selon le SKU: Autocomplete Session Usage.
La session de saisie semi-automatique a pris fin par un appel au SKU: Place Details (Basic, Advanced ou Preferred).
Un appel Place Details qui demande n'importe quel champ du SKU: Place Details (Basic, Advanced ou Preferred) est facturé selon le SKU: Place Details (Preferred).
La session de saisie semi-automatique a pris fin par un appel au SKU: Address Validation Preferred.
Pour en savoir plus, consultez la section Saisie semi-automatique (nouveau) et tarification des sessions.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,00 USD prix unitaire (0,00 USD pour 1 000) |
0,00 USD prix unitaire (0,00 USD pour 1 000) |
0,00 USD prix unitaire (0,00 USD pour 1 000) |
SKU : Place Details (IDs Only)
En utilisant un masque de champ ou une liste de champs dans une requête Place Details (New), vous pouvez limiter la réponse aux champs spécifiés. Ce SKU se déclenche lorsque vous demandez uniquement les champs suivants:
Service Web :
attributions
,
id
,
name
*,
photos
* Le champ name
contient le nom de ressource du lieu dans le formulaire: places/PLACE_ID
. Utilisez displayName
pour accéder au nom textuel du lieu.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0 USD prix unitaire (0 USD pour 1 000) |
0 USD prix unitaire (0 USD pour 1 000) |
0 USD prix unitaire (0 USD pour 1 000) |
SKU: Place Details (Location Only)
En utilisant un masque de champ ou une liste de champs dans une requête Place Details (New), vous pouvez limiter la réponse aux champs spécifiés. Ce SKU se déclenche lorsque votre requête ne concerne que les champs suivants :
Service Web :
addressComponents
,
adrFormatAddress
,
formattedAddress
,
location
,
plusCode
,
shortFormattedAddress
,
types
,
viewport
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,005 USD prix unitaire (5,00 USD pour 1 000) |
0,004 USD prix unitaire (4,00 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
SKU : Place Details (Basic)
En utilisant un masque de champ ou une liste de champs dans une requête Place Details (New), vous pouvez limiter la réponse aux champs spécifiés. Ce SKU se déclenche lorsque votre requête ne concerne que les champs suivants :
Service Web :
accessibilityOptions
,
businessStatus
,
displayName
,
googleMapsUri
,
iconBackgroundColor
,
iconMaskBaseUri
,
primaryType
,
primaryTypeDisplayName
,
subDestinations
,
utcOffsetMinutes
Si une session Autocomplete est interrompue par un appel Place Details qui demande n'importe quel champ à partir du SKU: Place Details (Basic, Advanced ou Preferred), l'appel est facturé selon le code SKU: Place Details (Preferred). Pour en savoir plus, consultez SKU: Autocomplete Session Usage.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,0170 USD prix unitaire (17,00 USD pour 1 000) |
0,0136 USD prix unitaire (13,60 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
SKU : Place Details (Advanced)
En utilisant un masque de champ ou une liste de champs dans une requête Place Details (New), vous pouvez limiter la réponse aux champs spécifiés. Ce SKU se déclenche lorsque votre requête ne concerne que les champs suivants :
Service Web :
currentOpeningHours
,
currentSecondaryOpeningHours
,
internationalPhoneNumber
,
nationalPhoneNumber
,
priceLevel
,
rating
,
regularOpeningHours
,
regularSecondaryOpeningHours
,
userRatingCount
,
websiteUri
Si une session Autocomplete est interrompue par un appel Place Details qui demande n'importe quel champ à partir du SKU: Place Details (Basic, Advanced ou Preferred), l'appel est facturé selon le code SKU: Place Details (Preferred). Pour en savoir plus, consultez SKU: Autocomplete Session Usage.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,020 USD prix unitaire (20,00 USD pour 1 000) |
0,016 USD prix unitaire (16,00 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
SKU : Place Details (Preferred)
En utilisant un masque de champ ou une liste de champs dans une requête Place Details (New), vous pouvez limiter la réponse aux champs spécifiés. Ce SKU se déclenche lorsque votre requête ne concerne que les champs suivants :
Service Web :
allowsDogs
,
curbsidePickup
,
delivery
,
dineIn
,
editorialSummary
,
evChargeOptions
,
fuelOptions
,
goodForChildren
,
goodForGroups
,
goodForWatchingSports
,
liveMusic
,
menuForChildren
,
parkingOptions
,
paymentOptions
,
outdoorSeating
,
reservable
,
restroom
,
allowsDogs
,
allowsDogs
,
allowsDogs
,
allowsDogs
,
allowsDogs
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
Si une session Autocomplete est interrompue par un appel Place Details qui demande n'importe quel champ à partir du SKU: Place Details (Basic, Advanced ou Preferred), l'appel est facturé selon le code SKU: Place Details (Preferred). Pour en savoir plus, consultez SKU: Autocomplete Session Usage.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,025 USD prix unitaire (25,00 USD pour 1 000) |
0,020 USD prix unitaire (20,00 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
SKU : Nearby Search (Basic)
En utilisant un masque de champ ou une liste de champs dans votre requête Nearby Search (New), vous pouvez limiter la réponse aux champs spécifiés. Ce SKU se déclenche lorsque votre requête ne concerne que les champs suivants :
Service Web :
places.accessibilityOptions
,
places.addressComponents
,
places.adrFormatAddress
,
places.attributions
,
places.businessStatus
,
places.displayName
,
places.formattedAddress
,
places.googleMapsUri
,
places.iconBackgroundColor
,
places.iconMaskBaseUri
,
places.id
,
places.location
,
places.name
*,
places.photos
,
places.plusCode
,
places.primaryType
,
places.accessibilityOptions
dans le champ places.accessibilityOptions
,
places.accessibilityOptions
places.name
places.primaryTypeDisplayName
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport
places/PLACE_ID
Utilisez places.displayName
pour accéder au nom textuel du lieu.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,032 USD prix unitaire (32,00 USD pour 1 000) |
0,0256 USD prix unitaire (25,60 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
SKU : Nearby Search (Advanced)
En utilisant un masque de champ ou une liste de champs dans votre requête Nearby Search (New), vous pouvez limiter la réponse aux champs spécifiés. Ce SKU se déclenche lorsque votre requête ne concerne que les champs suivants :
Service Web :
places.currentOpeningHours
,
places.currentSecondaryOpeningHours
,
places.internationalPhoneNumber
,
places.nationalPhoneNumber
,
places.priceLevel
,
places.rating
,
places.regularOpeningHours
,
places.regularSecondaryOpeningHours
,
places.userRatingCount
,
places.websiteUri
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,035 USD prix unitaire (35,00 USD pour 1 000) |
0,028 USD prix unitaire (28,00 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
SKU : Nearby Search (Preferred)
En utilisant un masque de champ ou une liste de champs dans votre requête Nearby Search (New), vous pouvez limiter la réponse aux champs spécifiés. Ce SKU se déclenche lorsque votre requête ne concerne que 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.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
places.reviews
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,040 USD prix unitaire (40,00 USD pour 1 000) |
0,032 USD prix unitaire (32,00 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
SKU : Text Search (ID Only)
En utilisant un masque de champ ou une liste de champs dans votre requête Text Search (New), vous pouvez limiter la réponse aux champs spécifiés. 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
contient le nom de ressource du lieu dans le formulaire: places/PLACE_ID
. Utilisez places.displayName
pour accéder au nom textuel du lieu.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0 USD prix unitaire (0 USD pour 1 000) |
0 USD prix unitaire (0 USD pour 1 000) |
0 USD prix unitaire (0 USD pour 1 000) |
SKU : Text Search (Basic)
En utilisant un masque de champ ou une liste de champs dans votre requête Text Search (New), vous pouvez limiter la réponse aux champs spécifiés. Ce SKU se déclenche lorsque votre requête ne concerne que les champs suivants :
Service Web :
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.viewport
places.utcOffsetMinutes
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,032 USD prix unitaire (32,00 USD pour 1 000) |
0,0256 USD prix unitaire (25,60 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
SKU : Text Search (Advanced)
En utilisant un masque de champ ou une liste de champs dans votre requête Text Search (New), vous pouvez limiter la réponse aux champs spécifiés. Ce SKU se déclenche lorsque votre requête ne concerne que les champs suivants :
Service Web :
places.currentOpeningHours
,
places.currentSecondaryOpeningHours
,
places.internationalPhoneNumber
,
places.nationalPhoneNumber
,
places.priceLevel
,
places.rating
,
places.regularOpeningHours
,
places.regularSecondaryOpeningHours
,
places.userRatingCount
,
places.websiteUri
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,035 USD prix unitaire (35,00 USD pour 1 000) |
0,028 USD prix unitaire (28,00 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
SKU : Text Search (Preferred)
En utilisant un masque de champ ou une liste de champs dans votre requête Text Search (New), vous pouvez limiter la réponse aux champs spécifiés. Ce SKU se déclenche lorsque votre requête ne concerne que 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.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
,
places.allowsDogs
places.reviews
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,040 USD prix unitaire (40,00 USD pour 1 000) |
0,032 USD prix unitaire (32,00 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
SKU : Place Photo
Un SKU Place Photo est facturé pour chaque requête envoyée à l'API.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,007 USD prix unitaire (7,00 USD pour 1 000) |
0,0056 USD prix unitaire (5,60 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
Tarifs de l'API 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 :
- Le service Place Autocomplete de l'API Places ou le service Place Autocomplete de l'API Maps JavaScript. Vous devez concevoir votre application de façon à fournir des jetons de session (vous devrez peut-être modifier le code existant).
- Le widget Autocomplete de l'API Maps JavaScript. La facturation basée sur les sessions est activée automatiquement pour ces widgets, sans qu'il soit nécessaire de modifier le code.
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 SKU Places Data
Les trois SKU Places Data sont Basic Data, Contact Data et Atmosphere Data.Un ou plusieurs SKU Data sont déclenchés pour :
- Android: : chaque requête vers
fetchPlace()
oufindCurrentPlace()
- iOS: : chaque appel fait à
fetchPlaceFromPlaceID:
oufindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- 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 appels des API Places suivantes 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
Si vous utilisez le paramètre "fields" dans votre requête Places Details ou Find Place, vous pouvez limiter la réponse à ces champs spécifiés uniquement. 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. Le SKU Basic Data se déclenche lorsque l'un de ces champs est demandé :
-
Android::
Place.Field.ADDRESS
,Place.Field.ADDRESS_COMPONENTS
,Place.Field.BUSINESS_STATUS
,Place.Field.ICON_BACKGROUND_COLOR
,Place.Field.ICON_URL
,Place.Field.ID
,Place.Field.LAT_LNG
,Place.Field.NAME
,Place.Field.PHOTO_METADATAS
,Place.Field.PLUS_CODE
,Place.Field.TYPES
,Place.Field.VIEWPORT
,Place.Field.UTC_OFFSET
ouPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
-
iOS::
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinessStatus
,GMSPlaceFieldID
,GMSPlaceFieldCoordinate
,GMSPlaceFieldName
,GMSPlaceFieldPhotos
,GMSPlaceFieldPlusCode
,GMSPlaceFieldTypes
ouGMSPlaceFieldViewport
-
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
ouwheelchair_accessible_entrance
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
Coût des requêtes Places + 0 USD |
Coût des requêtes Places + 0 USD |
Coût des requêtes Places + 0 USD |
Code SKU : Contact Data
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. Le SKU Contact Data se déclenche lorsque l'un des champs suivants est demandé :
-
Android::
Place.Field.CURRENT_OPENING_HOURS
,Place.Field.OPENING_HOURS
,Place.Field.PHONE_NUMBER
,Place.Field.SECONDARY_OPENING_HOURS
ouPlace.Field.WEBSITE_URI
-
iOS::
GMSPlaceFieldOpeningHours
,GMSPlaceFieldPhoneNumber
ouGMSPlaceFieldWebsite
-
Service Web:
formatted_phone_number
,international_phone_number
,opening_hours
,current_opening_hours
,secondary_opening_hours
ouwebsite
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
Coût des requêtes Places + 0,003 USD par appel (+ 3 USD pour 1 000) |
Coût des requêtes Places + 0,0024 USD par appel (+ 2,40 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
Code SKU : Atmosphere Data
Si vous utilisez le paramètre "fields" dans votre requête Places Details ou Find Place, vous pouvez limiter la réponse à ces champs spécifiés uniquement. Les champs de la catégorie Atmosphere génèrent des frais supplémentaires. Le SKU Atmosphere Data se déclenche lorsque l'un des champs suivants est demandé :
- 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
, ouPlace.Field.USER_RATINGS_TOTAL
- iOS: :
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
ouGMSPlaceFieldServesVegetarianFood
. - JavaScript : consultez Champs (Place Details).
- Service Web:
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
ouuser_ratings_total
.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
Coût des requêtes Places + 0,005 USD prix unitaire (+ 5 USD pour 1 000) |
Coût des requêtes Places + 0,004 USD prix unitaire (+ 4 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
SKU : Autocomplete – Per Request
Le SKU Autocomplete – Per Request est facturé pour chaque appel ou requête qui n'inclut pas de jeton de session :
- Android: :
findAutocompletePredictions()
- iOS: :
findAutocompletePredictionsFromQuery:
- JavaScript : service Place Autocomplete de l'API Maps JavaScript
- Service Web : service Place Autocomplete de l'API Places
Les appels effectués à partir d'une session Autocomplete non valide (par exemple, une session qui réutilise un jeton de session) sont également facturés à 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 si les appels sont effectués à partir d'une session Autocomplete non valide. Cette situation peut se produire lorsqu'un utilisateur saisit plusieurs adresses ou effectue un copier/coller de différentes adresses dans le widget, et qu'il ne sélectionne pas toujours la prédiction de saisie semi-automatique.
VOLUME MENSUEL (prix par REQUÊTE) |
||
---|---|---|
0,00283 USD prix unitaire (2,83 USD pour 1 000) |
0,00227 USD prix unitaire (2,27 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
SKU : Autocomplete without Place Details – Per Session
Le SKU Autocomplete without Places Details – Per Session est facturé pour une session Autocomplete qui n'inclut pas une requête Place Details (dans les quelques minutes qui suivent le début de la session).
VOLUME MENSUEL (prix par SESSION) |
||
---|---|---|
0,017 USD prix unitaire (17,00 USD pour 1 000) |
0,0136 USD prix unitaire (13,60 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
Exemple
Si votre application émet les deux appels suivants au cours d'une même session :
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
Service Web
- Requête Place Autocomplete (input=”par”, session_token: XYZ)
- Requête Place Autocomplete (input=”paris”, session_token: XYZ)
Sur votre facture, le SKU suivant est indiqué (lorsque vous affichez votre facture par SKU) :
- Autocomplete without Place Details – Per Session (prix à compter de 0,017 USD par session)
Code SKU : Autocomplete (included with Place Details) – Per Session
Le SKU Autocomplete (included with Place Details) – Per Session est facturé pour chaque session Autocomplete qui inclut l'un des éléments suivants :
- Android: : appel fait à
fetchPlace()
- iOS: : appel fait à
fetchPlaceFromPlaceID:
- Service Web : requête Places Details
La requête Autocomplete est disponible sans frais, et l'appel Place Details qui s'ensuit est facturé en fonction du tarif Place Details standard.
Une requête Places Details génère des SKU Data (Basic, Contact et/ou Atmosphere), en fonction des champs spécifiés dans la requête.
Si vous ne précisez pas de champs dans la requête Places Details, tous les SKU Data sont déclenchés (Basic, Contact et Atmosphere).
Les requêtes d'actualisation d'ID Place Details (requêtes qui ne spécifient que le champ place_id
) lors d'une session Autocomplete sont facturées comme SKU Autocomplete without Place Details – Per Session.
VOLUME MENSUEL (prix par SESSION) |
||
---|---|---|
0,00 USD | 0,00 USD | 0,00 USD |
Exemple
Si votre application émet les trois appels suivants au cours d'une même session :
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (avec un
FetchPlaceRequest
comprenant l'ID de lieu et le champ ADDRESS)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID: (y compris l'ID de lieu et le champ
GMSPlaceFieldFormattedAddress
)
Service Web
- Requête Places Autocomplete (input=”par”, session_token: XYZ)
- Requête Places Autocomplete (input=”paris”, session_token: XYZ)
- Places Details (place_id, session_token: XYZ, fields:formatted_address)
Sur votre facture, les SKU suivants sont indiqués (lorsque vous affichez votre facture par SKU) :
- Autocomplete (included with Place Details) – Per Session (facturé à 0,00 USD)
- Place Details (prix à partir de 0,017 USD par session)
- Basic Data (facturé à 0 USD)
SKU : Query Autocomplete – Per Request
Un SKU Query Autocomplete – Per Request est facturé pour chaque requête envoyée aux éléments suivants :
- JavaScript : service Places Autocomplete de l'API Maps JavaScript (
getQueryPredictions()
) et en fonction de l'utilisation du widget SearchBox de l'API Maps JavaScript (les requêtes Query Autocomplete sont générées au fur et à mesure de la saisie de l'utilisateur) - Service Web : le service Query Autocomplete de l'API Places
VOLUME MENSUEL (prix par REQUÊTE) |
||
---|---|---|
0,00283 USD prix unitaire (2,83 USD pour 1 000) |
0,00227 USD prix unitaire (2,27 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
La tarification par session Autocomplete n'est pas compatible avec la requête Query Autocomplete. Les appels Places Details qui s'ensuivent sont facturés en fonction du tarif Places Details standard.
SKU : Place Details
Les appels Place Details sont facturés comme suit :
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,017 USD prix unitaire (17,00 USD pour 1 000) |
0,0136 USD prix unitaire (13,60 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
Le SKU Place Details est généré à partir des API suivantes :
- Android: : SDK Places pour Android (
fetchPlace()
) - iOS: : SDK Places pour iOS (
fetchPlaceFromPlaceID:
) - JavaScript : service Place Details de l'API Maps JavaScript (
getDetails
) - JavaScript : widget Place Autocomplete de l'API Maps JavaScript (
getPlace
) - JavaScript:
widget Place SearchBox de l'API Maps JavaScript:
getPlaces()
une fois que l'utilisateur a sélectionné un résultat de lieu (icône: icône), *pas* une requête (icône : loupe), comme illustré ici :Dans les résultats du widget de champ de recherche, après avoir saisi "pizza" dans le champ de recherche, notez que Pizza Autentico est associé à une icône de punaise (et non à 0) - Service Web : service Place Details de l'API Places
Avec l'API et les services Web, le SKU Place Details est facturé, qu'un jeton de session soit fourni ou non.
Un appel ou une requête Place Details génère également des SKU Data (Basic, Contact et/ou Atmosphere), en fonction des champs spécifiés dans l'appel ou la requête. Si NO champ n'est indiqué dans l'appel ou la requête Places Details, NO les SKU Data sont déclenchés et vous êtes facturé pour l'appel ou la requête Places Details, ainsi que pour le coût de toutes les données.
Exemples
- Effectuez l'un de ces appels ou requêtes :
- Mobile : appelez
fetchPlace()
sur Android oufetchPlaceFromPlaceID:
sur iOS, et ne spécifiez que le champADDRESS
- API ou service Web : exécutez une requête Place Details et ne spécifiez que le champ d'adresse :
getPlaceDetails(fields: formatted_address)
- Place Details (prix à partir de 0,017 USD par session)
- Basic Data (facturé à 0 USD)
- Mobile : appelez
- Effectuez l'un de ces appels ou requêtes :
- Mobile : appelez
fetchPlace()
sur Android oufetchPlaceFromPlaceID:
sur iOS, et ne spécifiez que le champPHONE_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)
- Place Details (prix à partir de 0,017 USD par session)
- Contact Data (prix à partir de 0,003 USD par requête)
- Mobile : appelez
- Effectuez l'un de ces appels ou requêtes :
- Mobile : appelez
fetchPlace()
sur Android oufetchPlaceFromPlaceID:
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()
.
- Place Details (prix à partir de 0,017 USD par session)
- Basic Data (facturé à 0 USD)
- Contact Data (prix à partir de 0,003 USD par requête)
- Atmosphere Data (prix à partir de 0,005 USD par requête)
- Mobile : appelez
SKU : Place Details – ID Refresh
Utilisez la requête Place Details pour mettre à jour les ID de lieu non actualisés. Les requêtes de ce type sont disponibles sans frais.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,00 USD | 0,00 USD | 0,00 USD |
Exemple
Effectuez une requête Places Details en ne spécifiant que le champ d'identifiant de lieu : getPlaceDetails(fields: place_id)
.
Sur votre facture, le SKU suivant est indiqué (lorsque vous affichez votre facture par SKU) :
- Place Details – ID Refresh (facturé à 0 USD)
SKU : Find Place
Le SKU Find Place est facturé par requête Find Place.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,017 USD prix unitaire (17,00 USD pour 1 000) |
0,0136 USD prix unitaire (13,60 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
Les requêtes Find Place génèrent aussi des SKU Data (Basic, Contact et/ou Atmosphere), en fonction des champs spécifiés dans la requête. Comme c'est le cas pour les requêtes Place Details, vous pouvez utiliser le paramètre "fields" dans votre requête Find Place afin de limiter la réponse à ces champs spécifiés uniquement. Les requêtes Find Place et les données demandées vous sont facturées. Par défaut, si NO champ n'est demandé, seul l'identifiant de lieu est renvoyé. Par conséquent, aucuns frais de données supplémentaires ne sont facturés.
Exemples
- Vous exécutez une requête Find Place et ne spécifiez que le champ d'adresse :
FindPlace(fields: formatted_address)
. Sur votre facture, les SKU suivants sont indiqués (lorsque vous affichez votre facture par SKU) :- Find Place (prix à partir de 0,017 USD par appel)
- Basic Data (facturé à 0 USD)
- 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)
. Sur votre facture, les SKU suivants sont indiqués (lorsque vous affichez votre facture par SKU) :- Find Place (prix à partir de 0,017 USD par appel)
- Contact Data (prix à partir de 0,003 USD par requête)
- 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)
. Sur votre facture, les SKU suivants sont indiqués (lorsque vous affichez votre facture par SKU) :- Find Place (prix à partir de 0,017 USD par appel)
- Basic Data (facturé à 0 USD)
- Contact Data (prix à partir de 0,003 USD par requête)
- Atmosphere Data (prix à partir de 0,005 USD par requête)
SKU : Find Place – ID only
Find Place– ID only est facturé en fonction des requêtes Find Place qui ne spécifie que l'identifiant de lieu à renvoyer. Par défaut, si aucun champ n'est spécifié dans la requête Find Place, seul l'identifiant de lieu est renvoyé.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,00 USD | 0,00 USD | 0,00 USD |
Exemple
Vous exécutez une requête Find Place et ne spécifiez que le champ place_id
: FindPlace(fields: place_id)
.
Sur votre facture, le SKU suivant est indiqué (lorsque vous affichez votre facture par SKU) :
- Find Place – ID only (facturé à 0,00 USD)
SKU : Place – Nearby Search
Un SKU Place - Nearby Search est facturé pour les requêtes envoyées au service Place Nearby Search de l'API Maps JavaScript (nearbySearch()
) ou au service Nearby Search de l'API Places
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,032 USD prix unitaire (32,00 USD pour 1 000) |
0,0256 USD prix unitaire (25,60 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
Les requêtes Nearby 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 Nearby Search vous est facturée à partir de 0,032 USD par requête, ainsi que pour tous les SKU de type données (Basic Data, Contact Data et Atmosphere Data).
Exemple
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) :
- Place – Nearby Search (prix à partir de 0,032 USD par appel)
- Basic Data (facturé à 0 USD)
- Contact Data (prix à partir de 0,003 USD par requête)
- Atmosphere Data (prix à partir de 0,005 USD par requête)
SKU : Place – Text Search
Un SKU Place - Text Search est facturé pour les requêtes envoyées au service Places Text Search de l'API Maps JavaScript (textSearch()
) ou au service Text Search de l'API Places
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,032 USD prix unitaire (32,00 USD pour 1 000) |
0,0256 USD prix unitaire (25,60 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
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 à partir de 0,032 USD par requête, ainsi que pour tous les SKU de type données (Basic Data, Contact Data et Atmosphere Data).
Le SKU Place – Text Search est également généré par lewidget 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 :
![Sélection de requêtes pour le widget Places Details SearchBox](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/billing/images/places-details-search-box-widget-query.png?authuser=5&hl=fr)
Exemple
Vous effectuez une requête Text Search, par exemple : TextSearch(123 Main Street)
. Sur votre facture, les SKU suivants sont indiqués (lorsque vous affichez votre facture par SKU) :
- Place – Text Search (prix à partir de 0,032 USD par appel)
- Basic Data (facturé à 0 USD)
- Contact Data (prix à partir de 0,003 USD par requête)
- Atmosphere Data (prix à partir de 0,005 USD par requête)
SKU : Place Photo
Un SKU Place Photo est facturé pour :
- Android: : appels faits à
fetchPhoto()
- iOS: : appels faits à
loadPlacePhoto:
- JavaScript : requêtes envoyées au service Place Photos de l'API Places Library et Maps JavaScript en utilisant
PlacePhoto.getUrl()
pour obtenir des URL à partir desquelles charger des données de pixels d'image - Service Web : requêtes envoyées au service Place Photos de l'API Places
Pour le service JavaScript, appeler la méthode PlacePhoto.getUrl()
n'entraîne pas de facturation tant que l'URL n'est pas réellement utilisée pour obtenir les données de pixels.
VOLUME MENSUEL (prix par APPEL) |
||
---|---|---|
0,007 USD prix unitaire (7,00 USD pour 1 000) |
0,0056 USD prix unitaire (5,60 USD pour 1 000) |
Contactez le service commercial pour connaître le prix sur d'autres volumes |
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 toujours:
API Places (nouvelle version): la limite de débit est de 600 RPM (requêtes par minute) par méthode API et par projet. Cela signifie que chaque méthode API dispose d'un quota distinct.
API Places: la limite de débit est de 6 000 RPM (requêtes par minute). Il correspond à 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.
Gérer vos coûts d'utilisation
Pour gérer vos coûts d'utilisation de l'API Places ou répondre aux demandes du trafic de votre production, définissez des limites de quota quotidiennes pour toutes les requêtes adressées à une API. Les quotas quotidiens sont réinitialisés à minuit, heure du Pacifique.
Pour afficher ou modifier les limites de quota de l'API Places:
- Dans la console Cloud, ouvrez la page Quotas Google Maps Platform.
- Cliquez sur le menu déroulant des API, puis sélectionnez API Places.
- Pour afficher les limites de quota, faites défiler la page jusqu'à la fiche Requêtes.
Un tableau liste les noms et les limites de quota. - Pour modifier une limite de quota, cliquez sur l'icône Modifier correspondante.
Dans le champ Limite de quota de la boîte de dialogue qui s'affiche, saisissez la limite de quota quotidienne facturable souhaitée (dans la limite autorisée, si elle est spécifiée par Google), puis sélectionnez Enregistrer.
Si votre utilisation de l'API atteint la limite de quota facturable pour un jour donné, votre application ne pourra plus y accéder pendant le reste de cette journée.
Ressources associées pour la gestion des coûts
- Facturation et tarification dans Google Maps Platform
- Reporting et surveillance dans Google Maps Platform