Places API – Nutzung und Abrechnung

Die Abrechnung für die Places API (New) und die Places API erfolgt nach einem „Pay as you go“-Preismodell. Places API (New)- und Places API-Anfragen generieren Aufrufe an eine beliebige der mehreren SKUs. 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. Die 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, Dieses Guthaben wird automatisch auf die entsprechenden SKUs angewendet.

Preise für die Places API (New)

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.

Sitzungen mit automatischer Vervollständigung (neu)

Eine „Autocomplete (New)“-Sitzung enthält eine oder mehrere „Autocomplete (New)“-Anfragen und eine „Place Details (New)“- oder „Address Validation“-Anfrage. Dasselbe Sitzungstoken wird an die Autocomplete (New)-Anfrage und an die nachfolgende Place Details (New)- oder Adressbestätigungsanfrage ü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 berechnet, 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 Requests wird für jede Anfrage an die Autocomplete (New) API ohne Sitzungstoken berechnet.

Die Gebühr wird auch berechnet, wenn Sie Sitzungstokens verwenden und

  • Beenden Sie die Sitzungen mit einer einzelnen Anfrage an „Place Details (New)“, in der alle Felder angefordert werden, die in der SKU: Place Details (Location Only) definiert sind.
    • Jede „Place Autocomplete (New)“-Anfrage (bis zu 12 Anfragen) wird mit der SKU Autocomplete Requests abgerechnet.
    • Jede nachfolgende Anfrage vom Typ „Autocomplete (New)“ wird mit der SKU SKU: Autocomplete Session Usage abgerechnet.
  • Sie können die Sitzung beenden, 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: Autocomplete Session Usage

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

Diese SKU wird in den folgenden Fällen berechnet:

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

    • Jede „Place Autocomplete (New)“-Anfrage (bis zu 12 Anfragen) wird mit der SKU Autocomplete Requests abgerechnet.
    • Jede nachfolgende „Autocomplete (New)“-Anfrage wird über die SKU: Autocomplete Session Usage abgerechnet.

  • Autocomplete-Sitzung wurde durch einen Aufruf von SKU: Place Details (Basic, Advanced, or Preferred) beendet.

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

  • Autocomplete-Sitzung 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: attributions, 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, containingPlaces, displayName, googleMapsLinks*, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, pureServiceAreaBusiness, subDestinations, utcOffsetMinutes

* Das Feld googleMapsLinks befindet sich in der Vorabversion (Pre-GA) und die Nutzung während der Vorabversion ist kostenlos.

Wenn eine Autocomplete-Sitzung durch einen Places Details-Aufruf beendet wird, bei dem ein beliebiges Feld aus der SKU „Places Details (Basic, Advanced, or Preferred)“ angefordert wird, wird der Aufruf mit der SKU „Places 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, priceRange, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

Wenn eine Autocomplete-Sitzung durch einen Places Details-Aufruf beendet wird, bei dem ein beliebiges Feld aus der SKU „Places Details (Basic, Advanced, or Preferred)“ angefordert wird, wird der Aufruf mit der SKU „Places 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, reservable, restroom, reviews, routingSummaries,* servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout

* Nur Textsuche und Nearby Search

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: 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 „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.attributions, places.businessStatus, places.containingPlaces, places.displayName, places.formattedAddress, places.googleMapsLinks*, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.id, places.location, places.name**, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.pureServiceAreaBusiness, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

* Das Feld places.googleMapsLinks befindet sich in der Vorab-GA-Phase und die Nutzung während der Vorabversion ist kostenlos, d. h., die Abrechnung erfolgt mit 0 $.

** 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.priceRange, 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:

places.allowsDogsplaces.curbsidePickupplaces.deliveryplaces.dineInplaces.editorialSummaryplaces.evChargeOptionsplaces.fuelOptionsplaces.goodForChildrenplaces.goodForGroupsplaces.goodForWatchingSportsplaces.liveMusicplaces.menuForChildrenplaces.parkingOptionsplaces.paymentOptionsplaces.outdoorSeatingplaces.reservableplaces.restroomplaces.reviewsplaces.routingSummariesplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertplaces.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.attributions, places.id, places.name*, nextPageToken

* Das Feld places.name enthält den Ressourcennamen für den Ort im folgenden 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.containingPlaces, places.displayName, places.formattedAddress, places.googleMapsLinks*, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.location, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.pureServiceAreaBusiness, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

* Das Feld places.googleMapsLinks befindet sich in der Vorab-GA-Phase und die Nutzung während der Vorabversion ist kostenlos. Die Abrechnung erfolgt also mit 0 $.

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.priceRange, 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:

places.allowsDogsplaces.curbsidePickupplaces.deliveryplaces.dineInplaces.editorialSummaryplaces.evChargeOptionsplaces.fuelOptionsplaces.goodForChildrenplaces.goodForGroupsplaces.goodForWatchingSportsplaces.liveMusicplaces.menuForChildrenplaces.parkingOptionsplaces.paymentOptionsplaces.outdoorSeatingplaces.reservableplaces.restroomplaces.reviewsplaces.routingSummariesplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertplaces.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.ACCESSIBILITY_OPTIONS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_MASK_URL, Place.Field.ID, Place.Field.LOCATION, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT oder Place.Field.UTC_OFFSET.
  • 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.INTERNATIONAL_PHONE_NUMBER, Place.Field.OPENING_HOURS, 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 eins 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_RATING_COUNT
  • 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)

SKU: Place – Text Search

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 der Nutzer „pizza“ in das Suchfeld eingegeben hat, wird neben pizza delivery ein Lupensymbol angezeigt. Es handelt sich also um eine Ortsabfrage und kein Ergebnis.

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. Für die Maps JavaScript API gelten jedoch 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: Die Ratenbegrenzung beträgt 6.000 QPM (Anfragen pro Minute). Er wird als 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

Um die Nutzungskosten für die Places API zu steuern oder den Anforderungen Ihres Produktionstraffics gerecht zu werden, können Sie tägliche Kontingentlimits für alle Anfragen an eine API festlegen. 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.
    Sie enthält eine Tabelle mit Kontingentnamen und ‑limits.
  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.