Places API – Nutzung und Abrechnung

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

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. Kosten werden anhand folgender Formel 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, das automatisch1 auf die entsprechenden SKUs angewendet wird.

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.

Automatische Vervollständigung (neu)-Sitzungen

Eine „Autocomplete (New)“-Sitzung enthält mindestens eine „Autocomplete (New)“-Anfrage und höchstens eine „Place Details (New)“-Anfrage oder eine „Adressüberprüfung“-Anfrage. Dasselbe Sitzungstoken wird an die „Autocomplete (New)“- und die nachfolgende „Place Details (New)“- oder „Address Validation“-Anfrage übergeben.

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

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

Ein Sitzungstoken darf 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 berechnet, die kein Sitzungstoken enthält.

Es fallen auch Gebühren an, wenn Sie Sitzungstokens verwenden und entweder:

  • Beenden Sie die Sitzungen mit einer einzigen Anfrage an „Place Details (New)“, die alle unter SKU: Place Details (Location Only) definierten Felder anfordert.
    • 12 „Autocomplete (New)“-Anfragen werden nach SKU: Autocomplete Requests abgerechnet.
    • Jede nachfolgende „Autocomplete (New)“-Anfrage wird gemäß der SKU: Autocomplete Session Usage abgerechnet.
  • Mit einem Aufruf der SKU: Place Details (IDs Only) können Sie die Sitzung beenden oder beenden. Alle „Autocomplete (New)“-Anfragen werden dann mithilfe von SKU: Autocomplete Requests 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: Autocomplete Session Usage

Die SKU Autocomplete Session Usage wird für jede Anfrage an die Autocomplete (New) API mit einem Sitzungstoken berechnet.

Diese SKU wird in zwei Szenarien in Rechnung gestellt:

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

    • 12 „Autocomplete (New)“-Anfragen werden nach SKU: Autocomplete Requests abgerechnet.
    • Jede nachfolgende „Autocomplete (New)“-Anfrage wird gemäß der SKU: Autocomplete Session Usage abgerechnet.
  • Die Autocomplete-Sitzung wurde mit einem Aufruf von SKU: Place Details (Basic, Advanced oder Preferred) oder SKU: Address Validation Preferred beendet.

    Ein „Place Details“-Aufruf, bei dem ein beliebiges Feld aus SKU: Place Details (Basic, Advanced oder Preferred) angefordert wird, wird nach SKU: Place Details (Preferred) abgerechnet. Weitere Informationen finden Sie unter Automatische Vervollständigung (neu) und Sitzungspreise.

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 Sie nur die folgenden Felder anfordern:

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

Wird eine Autocomplete-Sitzung durch einen „Place Details“-Aufruf beendet, bei dem ein beliebiges Feld aus SKU: Place Details (Basic, Advanced oder Preferred) angefordert wird, wird der Aufruf nach SKU: Place Details (Preferred) abgerechnet. Weitere Informationen finden Sie unter SKU: Autocomplete Session Usage.

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

Wird eine Autocomplete-Sitzung durch einen „Place Details“-Aufruf beendet, bei dem ein beliebiges Feld aus SKU: Place Details (Basic, Advanced oder Preferred) angefordert wird, wird der Aufruf nach SKU: Place Details (Preferred) abgerechnet. Weitere Informationen finden Sie unter SKU: Autocomplete Session Usage.

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, {//9/}, {2//7, {2/7, allowsDogs, allowsDogs, {1/7, allowsDogs, allowsDogs, allowsDogs, allowsDogs, allowsDogs, allowsDogs, restroom, goodForWatchingSports, servesWine, goodForWatchingSports, liveMusic, restroom, servesWine, WebdienstreservablereviewsservesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertsservesDinnerservesLunchservesVegetarianFoodtakeout

Wird eine Autocomplete-Sitzung durch einen „Place Details“-Aufruf beendet, bei dem ein beliebiges Feld aus SKU: Place Details (Basic, Advanced oder Preferred) angefordert wird, wird der Aufruf nach SKU: Place Details (Preferred) abgerechnet. Weitere Informationen finden Sie unter SKU: Autocomplete Session Usage.

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 „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: 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 „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: 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 „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: 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, {//9/}, {2//7, {2/7, places.allowsDogs, places.allowsDogs, {1/7, places.allowsDogs, places.allowsDogs, places.allowsDogs, places.allowsDogs, places.allowsDogs, places.allowsDogs, places.restroom, places.goodForWatchingSports, places.servesWine, places.goodForWatchingSports, places.liveMusic, places.restroom, places.servesWine, Webdienstplaces.reservableplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.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 „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: 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 „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: 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.types, places.typesplaces.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 „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: 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 „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: 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, {//9/}, {2//7, {2/7, places.allowsDogs, places.allowsDogs, {1/7, places.allowsDogs, places.allowsDogs, places.allowsDogs, places.allowsDogs, places.allowsDogs, places.allowsDogs, places.restroom, places.goodForWatchingSports, places.servesWine, places.goodForWatchingSports, places.liveMusic, places.restroom, places.servesWine, Webdienstplaces.reservableplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.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, wird in den Ergebnissen des Suchfeld-Widgets ein Lupensymbol neben Pizzalieferdienst angezeigt. Das bedeutet, 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

Die Anzahl der Anfragen pro Tag ist nicht begrenzt. Es gelten jedoch die folgenden Nutzungslimits:

  • Places API (neu): Die Ratenbegrenzung beträgt 600 Anfragen pro Minute pro API-Methode und Projekt. Jede API-Methode hat also ein separates Kontingent.

  • Places API: Die Ratenbegrenzung beträgt 6.000 Abfragen pro Minute (Anfragen pro Minute). Er ist die Summe der clientseitigen und serverseitigen Anfragen für alle Anwendungen, die die Anmeldedaten desselben Projekts verwenden.

Nutzungsbedingungen – Einschränkungen

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

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.

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 sich die Kontingentlimits anzusehen.
    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.


  1. Nutzer in Indien müssen zuerst ein Google Cloud Platform-Rechnungskonto und dann ein Google Maps Platform-Rechnungskonto erstellen, um Guthaben für die Google Maps Platform zu erhalten.