Places API – Nutzung und Abrechnung

Für die Places API (New) und die Places API wird ein „Pay as you go“-Preismodell verwendet. Bei „Places API (New)“- und „Places API“-Anfragen werden Aufrufe an mehrere SKUs gesendet. Neben den Google-Nutzungsbedingungen gelten bestimmte Nutzungslimits für die Places API. Kosten und Nutzung verwalten – mit den in der Google Cloud Console verfügbaren Tools

Abrechnung für die Places API

Für die Places API (New) und die Places API gilt ein „Pay as you go“-Preismodell. Die APIs und SDKs der Google Maps Platform werden nach SKU abgerechnet. Die Nutzung wird für jede SKU erfasst. APIs oder SDKs können jeweils mehrere Produkt-SKUs haben. So werden die Kosten berechnet:

SKU-Nutzung × Preis pro Nutzung

Mit dem Preis- und Nutzungsrechner können Sie Ihre Kosten pro API oder SDK überschlagen. Für infrage kommende Google Maps Platform-SKUs ist pro Rechnungskonto ein monatliches Google Maps Platform-Guthaben in Höhe von 200 $ verfügbar, Dieses Guthaben wird automatisch auf die berechtigten SKUs angewendet.

Preise für die Places API (neu)

Feldmasken

Verwenden Sie für „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ den FieldMask-Header in API-Anfragen, um die Liste der Felder anzugeben, die in der Antwort zurückgegeben werden sollen. Ihnen wird dann die höchste SKU in Rechnung gestellt, die auf Ihre Anfrage anwendbar ist. Wenn Sie also Felder in der „(Basic)“- und der „(Advanced)“-SKU auswählen, wird Letztere für die Abrechnung verwendet.

Mit der Maskierung von Feldern lässt sich verhindern, dass unnötige Daten angefordert werden, was wiederum hilft, unnötige Verarbeitungszeiten und Gebühren zu vermeiden.

Autocomplete-Sitzungen (Neu)

Eine Autocomplete-Sitzung (Neu) umfasst eine oder mehrere „Autocomplete (New)“-Anfragen und eine „Place Details (New)“- oder „Address Validation“-Anfrage. Dasselbe Sitzungstoken wird an die „Autocomplete (New)“-Anfrage und die nachfolgende „Place Details (New)“- oder „Address Validation“-Anfrage übergeben.

Eine Sitzung beginnt mit der ersten „Autocomplete (New)“-Anfrage. Wenn der Nutzer einen der Autocomplete-Vorschläge (New) ausgewählt hat, wird eine „Place Details (New)“- oder „Address Validation“-Anfrage gestellt. Wenn eine Sitzung abgebrochen wird, d. h. keine „Place Details (New)“- oder „Address Validation“-Anfrage gestellt wird, werden Autocomplete (New)-Anfragen so in Rechnung gestellt, als wäre kein Sitzungstoken angegeben worden.

Nachdem ein Nutzer einen Ort ausgewählt hat, also eine „Place Details (New)“-Anfrage oder eine Address Validation-Anfrage gestellt wurde, müssen Sie eine neue Sitzung mit einem neuen Sitzungstoken starten.

Ein Sitzungstoken kann nur für eine Sitzung verwendet werden. Wenn Sie ein Token wiederverwenden, wird die Sitzung als ungültig betrachtet und die Anfragen werden so berechnet, als wäre kein Sitzungstoken angegeben worden.

SKU: Autocomplete-Anfragen

Die SKU Autocomplete-Anfragen wird für jede Anfrage an die Autocomplete (New) API ohne Sitzungstoken berechnet.

Sie wird auch in Rechnung gestellt, wenn Sie Sitzungstokens verwenden und eines der folgenden Kriterien erfüllt ist:

  • Beenden Sie die Sitzungen durch eine einzelne Anfrage an „Place Details (New)“, für die alle in der SKU: Place Details (Location Only) definierten Felder angefordert werden.
    • Jede „Autocomplete (New)“-Anfrage (bis zu 12 Anfragen) wird mit der SKU: Autocomplete-Anfragen abgerechnet.
    • Jede nachfolgende „Autocomplete (New)“-Anfrage wird mit der SKU: Autocomplete Session Usage abgerechnet.
  • Verlassen Sie die Sitzung oder beenden Sie sie, indem Sie die SKU: Place Details (IDs Only) aufrufen. Alle „Autocomplete (New)“-Anfragen werden dann mit der SKU: Autocomplete-Anfragen abgerechnet.
MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,00283 $
(2,83 $ pro 1.000)
Jeweils 0,00227 $
(2,27 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Nutzung der automatischen Vervollständigung von Sitzungen

Die SKU Autocomplete Session Usage wird für jede Anfrage an die Autocomplete (New) API berechnet, die ein Sitzungstoken enthält.

Diese SKU wird in folgenden Fällen berechnet:

  • Die Autocomplete-Sitzung wurde durch einen Aufruf von SKU: Place Details (Location Only) beendet:

    • Jede „Autocomplete (New)“-Anfrage (bis zu 12 Anfragen) wird mit der SKU: Autocomplete-Anfragen abgerechnet.
    • Jede nachfolgende „Autocomplete (New)“-Anfrage wird mit der SKU: Autocomplete Session Usage abgerechnet.
  • Die Autocomplete-Sitzung wurde mit einem Aufruf von SKU: Place Details (Basic, Advanced oder Preferred) beendet.

    Ein „Place Details“-Aufruf, bei dem ein beliebiges Feld aus der SKU: Place Details (Basic, Advanced oder Preferred) angefordert wird, wird nach der SKU: Place Details (Preferred) abgerechnet.

  • Die automatische Vervollständigung wurde mit einem Aufruf von SKU: Address Validation Preferred beendet.

Weitere Informationen finden Sie unter Preise für automatische Vervollständigung (neu) und Sitzungen.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 über 500.000
Jeweils 0,00 $
(0,00 $ pro 1.000)
Jeweils 0,00 $
(0,00 $ pro 1.000)
Jeweils 0,00 $
(0,00 $ pro 1.000)

SKU: Place Details (IDs Only)

Wenn Sie eine Feldmaske oder Feldliste in Ihrer „Place Details (New)“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Diese SKU wird ausgelöst, wenn du nur die folgenden Felder anforderst:

Webdienst: id, name*, photos

* Das Feld name enthält den Ressourcennamen des Orts in folgendem Format: places/PLACE_ID. Verwenden Sie displayName, um auf den Textnamen des Orts zuzugreifen.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,00 $
(0,00 $ pro 1.000)
Jeweils 0,00 $
(0,00 $ pro 1.000)
Jeweils 0,00 $
(0,00 $ pro 1.000)

SKU: Place Details (Location Only)

Wenn Sie eine Feldmaske oder Feldliste in Ihrer „Place Details (New)“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Diese SKU wird ausgelöst, wenn Sie nur die folgenden Felder anfordern:

Webdienst: addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,005 $
(5,00 $ pro 1.000)
Jeweils 0,004 $
(4,00 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Place Details (Basic)

Wenn Sie eine Feldmaske oder Feldliste in Ihrer „Place Details (New)“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Diese SKU wird ausgelöst, wenn Sie nur die folgenden Felder anfordern:

Webdienst: accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations, utcOffsetMinutes

Wenn eine Autocomplete-Sitzung durch einen „Place Details“-Aufruf beendet wird, mit dem ein beliebiges Feld aus der SKU: Place Details (Basic, Advanced oder Preferred) angefordert wird, wird der Aufruf über SKU: Place Details (Preferred) abgerechnet. Weitere Informationen finden Sie unter SKU: Nutzung der automatischen Vervollständigung von Sitzungen.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,017 $
(17,00 $ pro 1.000)
Jeweils 0,0136 $
(13,60 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Place Details (Advanced)

Wenn Sie eine Feldmaske oder Feldliste in Ihrer „Place Details (New)“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Diese SKU wird ausgelöst, wenn Sie nur die folgenden Felder anfordern:

Webdienst: currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

Wenn eine Autocomplete-Sitzung durch einen „Place Details“-Aufruf beendet wird, mit dem ein beliebiges Feld aus der SKU: Place Details (Basic, Advanced oder Preferred) angefordert wird, wird der Aufruf über SKU: Place Details (Preferred) abgerechnet. Weitere Informationen finden Sie unter SKU: Nutzung der automatischen Vervollständigung von Sitzungen.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,02 $
(20,00 $ pro 1.000)
Jeweils 0,016 $
(16,00 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Place Details (Preferred)

Wenn Sie eine Feldmaske oder Feldliste in Ihrer „Place Details (New)“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Diese SKU wird ausgelöst, wenn Sie nur die folgenden Felder anfordern:

Webdienst: allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, allowsDogs, , /reviews servesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertsservesDinnerservesLunchservesVegetarianFoodservesWinetakeout

Wenn eine Autocomplete-Sitzung durch einen „Place Details“-Aufruf beendet wird, mit dem ein beliebiges Feld aus der SKU: Place Details (Basic, Advanced oder Preferred) angefordert wird, wird der Aufruf über SKU: Place Details (Preferred) abgerechnet. Weitere Informationen finden Sie unter SKU: Nutzung der automatischen Vervollständigung von Sitzungen.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,025 $
(25,00 $ pro 1.000)
Jeweils 0,02 $
(20,00 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Nearby Search (Basic)

Wenn Sie eine Feldmaske oder Feldliste in Ihrer „Nearby Search (New)“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Diese SKU wird ausgelöst, wenn Sie nur die folgenden Felder anfordern:

Webdienst: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, 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.primaryTypeDisplayName, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

* Das Feld places.name enthält den Ressourcennamen des Orts in folgendem Format: places/PLACE_ID. Verwenden Sie places.displayName, um auf den Textnamen des Orts zuzugreifen.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,032 $
(32,00 $ pro 1.000)
Jeweils 0,0256 $
(25,60 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Nearby Search (Advanced)

Wenn Sie eine Feldmaske oder Feldliste in Ihrer „Nearby Search (New)“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Diese SKU wird ausgelöst, wenn Sie nur die folgenden Felder anfordern:

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

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,035 $
(35,00 $ pro 1.000)
Jeweils 0,028 $
(28,00 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Nearby Search (Preferred)

Wenn Sie eine Feldmaske oder Feldliste in Ihrer „Nearby Search (New)“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Diese SKU wird ausgelöst, wenn Sie nur die folgenden Felder anfordern:

Webdienst: 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.reviews places.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,04 $
(40,00 $ pro 1.000)
Jeweils 0,032 $
(32,00 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Text Search (ID Only)

Wenn Sie eine Feldmaske oder Feldliste in Ihrer „Text Search (New)“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Diese SKU wird ausgelöst, wenn Sie nur die folgenden Felder anfordern:

Webdienst: places.id, places.name*

* Das Feld places.name enthält den Ressourcennamen des Orts in folgendem Format: places/PLACE_ID. Verwenden Sie places.displayName, um auf den Textnamen des Orts zuzugreifen.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,00 $
(0,00 $ pro 1.000)
Jeweils 0,00 $
(0,00 $ pro 1.000)
Jeweils 0,00 $
(0,00 $ pro 1.000)

SKU: Text Search (Basic)

Wenn Sie eine Feldmaske oder Feldliste in Ihrer „Text Search (New)“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Diese SKU wird ausgelöst, wenn Sie nur die folgenden Felder anfordern:

Webdienst: 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.utcOffsetMinutesplaces.viewport

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,032 $
(32,00 $ pro 1.000)
Jeweils 0,0256 $
(25,60 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Text Search (Advanced)

Wenn Sie eine Feldmaske oder Feldliste in Ihrer „Text Search (New)“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Diese SKU wird ausgelöst, wenn Sie nur die folgenden Felder anfordern:

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

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,035 $
(35,00 $ pro 1.000)
Jeweils 0,028 $
(28,00 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Text Search (Preferred)

Wenn Sie eine Feldmaske oder Feldliste in Ihrer „Text Search (New)“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Diese SKU wird ausgelöst, wenn Sie nur die folgenden Felder anfordern:

Webdienst: 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.reviews places.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,04 $
(40,00 $ pro 1.000)
Jeweils 0,032 $
(32,00 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Place Photo

Die SKU Place Photo wird für jede Anfrage an die API berechnet.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,007 $
(7,00 $ pro 1.000)
Jeweils 0,0056 $
(5,60 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

Preise für die Places API

Autocomplete-Sitzungen

Eine Autocomplete-Sitzung enthält Autocomplete-Anfragen (zum Abrufen von Vorschlägen für einen Ort, während der Nutzer tippt) und höchstens eine „Place Details“-Anfrage (zum Abrufen von Details zum vom Nutzer ausgewählten Ort). Dasselbe Sitzungstoken wird an die Autocomplete- und nachfolgende „Place Details“-Anfrage übergeben. Eine Sitzung beginnt mit der ersten Autocomplete-Anfrage, also in der Regel, wenn der Nutzer anfängt zu tippen. Ein „Places Details“-Aufruf wird ausgeführt, wenn der Nutzer einen der Autocomplete-Vorschläge ausgewählt hat. Wenn ein Nutzer keinen Vorschlag auswählt, wird kein „Place Details“-Aufruf ausgeführt.

Nachdem ein Nutzer einen Ort ausgewählt hat (d. h., ein „Place Details“-Aufruf wird ausgeführt), müssen Sie eine neue Sitzung mit einem neuen Sitzungstoken starten.

Autocomplete-Sitzungen können über folgende APIs generiert werden:

Ein Sitzungstoken darf nur für eine Nutzersitzung verwendet werden. Wenn Sie ein Token wiederverwenden, wird die Sitzung als ungültig betrachtet und die Anfragen werden so berechnet, als wäre kein Sitzungstoken angegeben worden.

Die Autocomplete-Anfragen und die „Place Details“-Anfragen mit Sitzungen werden nach verschiedenen SKUs abgerechnet.

Places-Daten-SKUs

Die drei Places-Daten-SKUs sind Basic Data, Contact Data und Atmosphere Data.

Mindestens eine Daten-SKU wird ausgelöst für:

  • Android: jede Anfrage an fetchPlace() oder findCurrentPlace()
  • iOS: jeden Aufruf von fetchPlaceFromPlaceID: oder findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Webdienst: jede Places-Anfrage, je nach den Feldern, die in der Anfrage angegeben sind

Daten-SKUs werden immer zusätzlich zur Basis-SKU für die Anfrage in Rechnung gestellt, die sie auslöst. Eine „Place Details“-Anfrage mit „Basic Data“-Feldern wird beispielsweise sowohl unter der SKU „Basic Data“ als auch unter der SKU „Place Details“ in Rechnung gestellt.

Für den Webdienst können bei den folgenden Aufrufen der Places APIs die Datenfelder angegeben werden, die zurückgegeben werden sollen:

Bei den folgenden Aufrufen ist das NICHT möglich. Hier werden immer alle Places-Daten zurückgegeben und die drei Places-Daten-SKUs zusätzlich zu den Gebühren für jede API-Anfrage abgerechnet.


SKU: Basic Data

Wenn Sie den Parameter „fields“ in Ihrer „Place Details“- oder „Find Place“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Felder in der Kategorie Basic sind in den Grundkosten der Places-Anfrage enthalten und verursachen keine zusätzlichen Kosten. Die SKU Basic Data wird ausgelöst, wenn eines der folgenden Felder angefragt wird:

  • 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 oder Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
  • iOS:GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinessStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes oder GMSPlaceFieldViewport
  • Webdienst:address_component, adr_address, business_status, formatted_address, geometry, icon, name, permanently_closed, photo, place_id, plus_code, type, url, utc_offset, vicinity oder wheelchair_accessible_entrance
MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Kosten für Places-Anfrage
+ 0,00 $
Kosten für Places-Anfrage
+ 0,00 $
Kosten für Places-Anfrage
+ 0,00 $

SKU: Contact Data

Wenn Sie den Parameter „fields“ in Ihrer „Place Details“- oder „Find Place“-Anfrage für Webdienste oder ein Array von Place.Fields für Android oder iOS verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Für Felder in der Kategorie Contact fallen zusätzliche Kosten an. Die SKU Contact Data wird ausgelöst, wenn eines der folgenden Felder angefragt wird:

  • Android:Place.Field.CURRENT_OPENING_HOURS, Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.SECONDARY_OPENING_HOURS oder Place.Field.WEBSITE_URI
  • iOS:GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber oder GMSPlaceFieldWebsite
  • Webdienst:formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours oder website
MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Kosten für Places-Anfrage
+ jeweils 0,003 $
(+ 3,00 $ für 1.000)
Kosten für Places-Anfrage
+ jeweils 0,0024 $
(+ 2,40 $ für 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Atmosphere Data

Wenn Sie den Parameter „fields“ in Ihrer „Places Details“- oder „Find Place“-Anfrage verwenden, können Sie die Antwort auf die angegebenen Felder beschränken. Für Felder in der Kategorie Atmosphere fallen zusätzliche Kosten an. Die SKU Atmosphere Data wird ausgelöst, wenn eines der folgenden Felder angefragt wird:

  • 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 oder Place.Field.USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable, GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch oder GMSPlaceFieldServesVegetarianFood
  • JavaScript: weitere Informationen finden Sie unter Felder (Place Details)
  • Webdienst: 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 oder user_ratings_total.
MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Kosten für Places-Anfrage
+ jeweils 0,005 $
(+ 5,00 $ für 1.000)
Kosten für Places-Anfrage
+ jeweils 0,004 $
(+ 4,00 $ für 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Autocomplete – Per Request

Die SKU Autocomplete – Per Request wird für folgende Aufrufe oder Anfragen ohne Sitzungstoken berechnet:

Für Aufrufe, die über eine ungültige Autocomplete-Sitzung gesendet wurden, werden ebenfalls Kosten für eine SKU „Autocomplete – Per Request“ berechnet. Das kann z. B. der Fall sein, wenn ein Sitzungstoken wiederverwendet wird.

Auch für Autocomplete-Anfragen über das Place Autocomplete-Widget der Maps JavaScript API können Kosten für eine SKU „Autocomplete – Per Request“ anfallen, wenn Aufrufe über eine ungültige Autocomplete-Sitzung gesendet werden. Dazu kann es kommen, wenn ein Nutzer verschiedene Adressen in das Widget eingibt oder kopiert und nicht jedes Mal einen Autocomplete-Vorschlag auswählt.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro ANFRAGE)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,00283 $
(2,83 $ pro 1.000)
Jeweils 0,00227 $
(2,27 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

SKU: Autocomplete without Place Details – Per Session

Die SKU Autocomplete without Place Details – Per Session wird für Autocomplete-Sitzungen ohne „Place Details“-Anfrage innerhalb der ersten Sitzungsminuten berechnet.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro SITZUNG)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,017 $
(17,00 $ pro 1.000)
Jeweils 0,0136 $
(13,60 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

Beispiel

Wenn Ihre Anwendung die folgenden zwei Aufrufe in einer einzelnen Sitzung ausgibt:

Android

iOS

Webdienst

Auf Ihrer Rechnung wird die folgende SKU ausgewiesen (wenn Sie die Rechnung nach SKU filtern):

  • Autocomplete without Place Details – Per Session (ab 0,017 $ pro Sitzung)

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

Die SKU Autocomplete (included with Place Details) – Per Session wird für Autocomplete-Sitzungen mit folgenden Aufrufen oder Anfragen berechnet:

  • Android: Aufruf von fetchPlace()
  • iOS: Aufruf von fetchPlaceFromPlaceID:
  • Webdienst: „Place Details“-Anfrage

Die Autocomplete-Anfrage ist kostenlos. Der nachfolgende „Place Details“-Aufruf wird auf Grundlage der üblichen „Place Details“-Preise berechnet.

Durch „Place Details“-Anfragen werden je nach den Feldern, die in der Anfrage angegeben wurden, auch Daten-SKUs (Basic, Contact und/oder Atmosphere) generiert.

Wenn Sie in der „Place Details“-Anfrage keine Felder angeben, werden alle Daten-SKUs ausgelöst (also „Basic“, „Contact“ und „Atmosphere“).

„Place Details – ID Refresh“-Anfragen (Anfragen, in denen nur das Feld place_id angegeben ist) in Autocomplete-Sitzungen werden als SKU: Autocomplete without Place Details – Per Session abgerechnet.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro SITZUNG)
0–100.000 100.001–500.000 Über 500.000
0,00 $ 0,00 $ 0,00 $

Beispiel

Wenn Ihre Anwendung die folgenden drei Aufrufe in einer einzelnen Sitzung ausgibt:

Android

iOS

Webdienst

Auf Ihrer Rechnung werden die folgenden SKUs ausgewiesen (wenn Sie die Rechnung nach SKU filtern):

  • Autocomplete (included with Place Details) – Per Session (0,00 $)
  • Place Details (ab 0,017 $ pro Sitzung)
  • Basic Data (0,00 $)

SKU: Query Autocomplete – Per Request

Die SKU Query Autocomplete – Per Request wird für folgende Anfragen berechnet:

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro ANFRAGE)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,00283 $
(2,83 $ pro 1.000)
Jeweils 0,00227 $
(2,27 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

Bei der Nutzung von „Query Autocomplete“ kann nicht nach Autocomplete-Sitzung abgerechnet werden. Nachfolgende „Place Details“-Aufrufe werden basierend auf den üblichen „Place Details“-Preisen berechnet.


SKU: Place Details

Für „Place Details“-Aufrufe fallen folgende Kosten an:

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,017 $
(17,00 $ pro 1.000)
Jeweils 0,0136 $
(13,60 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

Die SKU Place Details wird aus den folgenden APIs generiert:

Bei Web-API und Webdiensten wird die SKU „Place Details“ unabhängig davon abgerechnet, ob ein Sitzungstoken angegeben ist oder nicht.

Durch „Place Details“-Aufrufe oder ‑Anfragen werden je nach den Feldern, die dabei angegeben wurden, auch Daten-SKUs (Basic, Contact und/oder Atmosphere) generiert. Werden in „Place Details“-Aufrufen oder ‑Anfragen KEINE Felder angegeben, werden ALLE Daten-SKUs ausgelöst und sowohl der Aufruf bzw. die Anfrage sowie die Kosten für alle Daten berechnet.

Beispiele

  1. Gehen Sie so vor:
    • Mobilgerät: Rufen Sie fetchPlace() (Android) oder fetchPlaceFromPlaceID: (iOS) auf und geben Sie nur das Feld ADDRESS an.
    • Web-API oder Webdienst: Stellen Sie eine „Place Details“-Anfrage und geben Sie nur das Adressfeld an – getPlaceDetails(fields: formatted_address).
    Auf Ihrer Rechnung werden die folgenden SKUs ausgewiesen (wenn Sie die Rechnung nach SKU filtern):
    • Place Details (ab 0,017 $ pro Sitzung)
    • Basic Data (0,00 $)
  2. Gehen Sie so vor:
    • Mobilgerät: Rufen Sie fetchPlace() (Android) oder fetchPlaceFromPlaceID: (iOS) auf und geben Sie nur das Feld PHONE_NUMBER an.
    • Web-API oder Webdienst: Stellen Sie eine „Place Details“-Anfrage und geben Sie das Feld für die Telefonnummer an – getPlaceDetails(fields: formatted_phone_number).
    Auf Ihrer Rechnung werden die folgenden SKUs ausgewiesen (wenn Sie die Rechnung nach SKU filtern):
    • Place Details (ab 0,017 $ pro Sitzung)
    • Contact Data (ab 0,003 $ pro Anfrage)
  3. Gehen Sie so vor:
    • Mobilgerät: Rufen Sie fetchPlace() (Android) oder fetchPlaceFromPlaceID: (iOS) auf und geben Sie alle Felder an.
    • Web-API oder Webdienst: Stellen Sie eine „Place Details“-Anfrage und geben Sie alle Felder an (das ist die Standardanfrage, wenn Sie keine Felder angeben) – getPlaceDetails().
    Auf Ihrer Rechnung werden die folgenden SKUs ausgewiesen (wenn Sie die Rechnung nach SKU filtern):
    • Place Details (ab 0,017 $ pro Sitzung)
    • Basic Data (0,00 $)
    • Contact Data (ab 0,003 $ pro Anfrage)
    • Atmosphere Data (ab 0,005 $ pro Anfrage)

SKU: Place Details – ID Refresh

Sie können diese „Place Details“-Anfrage verwenden, um veraltete Orts-IDs zu aktualisieren. Solche Anfragen sind kostenlos.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
0,00 $ 0,00 $ 0,00 $

Beispiel

Sie stellen eine „Place Details“-Anfrage und geben nur das Feld für die Orts-ID an: getPlaceDetails(fields: place_id). Auf Ihrer Rechnung wird die folgende SKU ausgewiesen (wenn Sie die Rechnung nach SKU filtern):

  • Place Details – ID Refresh (0,00 $)

SKU: Find Place

Find Place wird für „Find Place“-Anfragen berechnet.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,017 $
(17,00 $ pro 1.000)
Jeweils 0,0136 $
(13,60 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

Durch „Find Place“-Anfragen werden je nach den Feldern, die in der Anfrage angegeben wurden, auch Daten-SKUs (Basic, Contact und/oder Atmosphere) generiert. Genau wie bei „Place Details“-Anfragen können Sie den Parameter „fields“ auch in Ihrer „Find Place“-Anfrage verwenden und die Antwort so auf die angegebenen Felder beschränken. Es werden sowohl die „Find Place“-Anfrage als auch die angefragten Daten in Rechnung gestellt. Wenn KEINE Felder angefragt werden, wird standardmäßig nur die Orts-ID zurückgegeben. Es fallen dann keine zusätzlichen Kosten für Daten an.

Beispiele

  1. Sie stellen eine „Find Place“-Anfrage und geben nur das Adressfeld an: FindPlace(fields: formatted_address). Auf Ihrer Rechnung werden die folgenden SKUs ausgewiesen (wenn Sie die Rechnung nach SKU filtern):
    • Find Place (ab 0,017 $ pro Aufruf)
    • Basic Data (0,00 $)
  2. Sie stellen eine „Find Place“-Anfrage und geben das Feld für die Telefonnummer an: FindPlace(fields: formatted_phone_number). Auf Ihrer Rechnung werden die folgenden SKUs ausgewiesen (wenn Sie die Rechnung nach SKU filtern):
    • Find Place (ab 0,017 $ pro Aufruf)
    • Contact Data (ab 0,003 $ pro Anfrage)
  3. Sie stellen eine „Find Place“-Anfrage und geben Felder für alle drei Daten-Buckets an: FindPlace(fields: formatted_address, opening_hours, price_level). Auf Ihrer Rechnung werden die folgenden SKUs ausgewiesen (wenn Sie die Rechnung nach SKU filtern):
    • Find Place (ab 0,017 $ pro Aufruf)
    • Basic Data (0,00 $)
    • Contact Data (ab 0,003 $ pro Anfrage)
    • Atmosphere Data (ab 0,005 $ pro Anfrage)

SKU: Find Place – ID only

Die SKU Find Place – ID only wird für „Find Place“-Anfragen berechnet, bei denen nur die Orts-ID zurückgegeben werden soll. Wenn in der „Find Place“-Anfrage keine Felder angegeben sind, wird standardmäßig nur die Orts-ID zurückgegeben.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
0,00 $ 0,00 $ 0,00 $

Beispiel

Sie stellen eine „Find Place“-Anfrage und geben nur das Feld place_id an: FindPlace(fields: place_id). Auf Ihrer Rechnung wird die folgende SKU ausgewiesen (wenn Sie die Rechnung nach SKU filtern):

  • Find Place – ID only (0,00 $)

Place – Nearby Search wird für Anfragen an den „Place Nearby Search“-Dienst der Maps JavaScript API (nearbySearch()) oder den „Nearby Search“-Dienst der Places API berechnet.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,032 $
(32,00 $ pro 1.000)
Jeweils 0,0256 $
(25,60 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

Bei „Nearby Search“-Anfragen wird eine Liste von Orten zurückgegeben, Sie können aber nicht festlegen, welche Felder zurückgegeben werden sollen. Es wird eine Teilmenge der unterstützten Datenfelder zurückgegeben. Ihnen werden die „Nearby Search“-Anfrage (ab 0,032 $ pro Anfrage) sowie alle Daten-SKUs (Basic Data, Contact Data und Atmosphere Data) in Rechnung gestellt.

Beispiel

Sie stellen eine „Nearby Search“-Anfrage wie NearbySearch (San Francisco, 100 meters). Auf Ihrer Rechnung werden die folgenden SKUs ausgewiesen (wenn Sie die Rechnung nach SKU filtern):

  • Place – Nearby Search (ab 0,032 $ pro Aufruf)
  • Basic Data (0,00 $)
  • Contact Data (ab 0,003 $ pro Anfrage)
  • Atmosphere Data (ab 0,005 $ pro Anfrage)

Place – Text Search wird für Anfragen an den „Place Text Search“-Dienst der Maps JavaScript API (textSearch()) oder den „Text Search“-Dienst der Places API berechnet.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,032 $
(32,00 $ pro 1.000)
Jeweils 0,0256 $
(25,60 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

Bei „Text Search“-Anfragen wird eine Liste von Orten zurückgegeben, Sie können aber nicht festlegen, welche Felder zurückgegeben werden sollen. Es wird eine Teilmenge der unterstützten Datenfelder zurückgegeben. Ihnen werden die „Text Search“-Anfrage (ab 0,032 $ pro Anfrage) sowie alle Daten-SKUs (Basic Data, Contact Data und Atmosphere Data) in Rechnung gestellt.

Die SKU „Place – Text Search“ wird auch generiert, wenn die Methode getPlaces() des Widgets „Place SearchBox“ der Maps JavaScript API aufgerufen wird und der Nutzer eine Ortsabfrage (Lupensymbol) und kein Ortsergebnis (Stecknadelsymbol) auswählt, wie hier dargestellt:

Widget „Place Details Search Box“ – Abfrageauswahl
Nachdem Sie „Pizza“ in das Suchfeld eingegeben haben, sehen Sie in den Ergebnissen des Suchfeld-Widgets, dass neben dem Pizzalieferservice ein Lupensymbol angezeigt wird, das darauf hinweist, dass es sich um eine Ortsabfrage (und nicht um ein Ergebnis) handelt.

Beispiel

Sie stellen eine „Text Search“-Anfrage wie TextSearch(123 Main Street). Auf Ihrer Rechnung werden die folgenden SKUs ausgewiesen (wenn Sie die Rechnung nach SKU filtern):

  • Place – Text Search (ab 0,032 $ pro Aufruf)
  • Basic Data (0,00 $)
  • Contact Data (ab 0,003 $ pro Anfrage)
  • Atmosphere Data (ab 0,005 $ pro Anfrage)

SKU: Place Photo

Die SKU Place Photo wird berechnet für:

Für den JavaScript-Dienst fallen beim Aufruf der Methode PlacePhoto.getUrl() nur Kosten an, wenn die URL tatsächlich verwendet wird, um Pixeldaten abzurufen.

MONATLICHES NUTZUNGSVOLUMEN – BEREICHE
(Preis pro AUFRUF)
0–100.000 100.001–500.000 Über 500.000
Jeweils 0,007 $
(7,00 $ pro 1.000)
Jeweils 0,0056 $
(5,60 $ pro 1.000)
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren

Sonstige Nutzungslimits

Auch wenn die Anzahl der Anfragen pro Tag nicht begrenzt ist, gelten die folgenden Nutzungslimits:

  • Places API (New): Das Ratenlimit beträgt 600 Abfragen pro Minute (Anfragen pro Minute) pro API-Methode und Projekt. Das bedeutet, dass jede API-Methode ein separates Kontingent hat.

  • Places API: Das Ratenlimit beträgt 6.000 Abfragen pro Minute (Anfragen pro Minute). Zur Berechnung wird die Summe der clientseitigen und serverseitigen Anfragen für alle Anwendungen berechnet, die die Anmeldedaten desselben Projekts verwenden.

Nutzungsbedingungen – Einschränkungen

Informationen zu den Nutzungsbedingungen finden Sie in den Nutzungsbedingungen für die Google Maps Platform in den Richtlinien für die Places API und im Abschnitt zu Lizenzbeschränkungen.

Nutzungskosten verwalten

Sie können tägliche Kontingentlimits für alle Anfragen an eine API festlegen, um die Nutzungskosten für die Places API zu steuern oder den Anforderungen Ihres Produktionstraffics gerecht zu werden. Die Kontingente werden jeden Tag um Mitternacht (Pacific Standard Time) zurückgesetzt.

So können Sie Kontingentlimits für die Places API ansehen oder ändern:

  1. Öffnen Sie in der Cloud Console die Google Maps Platform-Seite „Kontingente“.
  2. Klicken Sie auf das Drop-down-Menü „APIs“ und wählen Sie die Places API aus.
  3. Scrollen Sie nach unten zur Karte Anfragen, um die Kontingentlimits zu sehen.
    In einer Tabelle sind die Kontingentnamen und ‑limits aufgeführt.
  4. Wenn Sie ein Kontingentlimit ändern möchten, klicken Sie auf das Symbol Bearbeiten für dieses Limit.
    Es wird ein Dialogfeld eingeblendet. Geben Sie unter Kontingentlimit das gewünschte tägliche Limit für das abrechnungsfähige Kontingent ein (bis zu dem von Google festgelegten Wert, sofern vorhanden). Klicken Sie dann auf Speichern.

Wenn die API-Nutzung an einem Tag das Limit für das abrechnungsfähige Kontingent erreicht, kann die App für den Rest des Tages nicht mehr auf die API zugreifen.