Fehler: 9005 PLACES_API_RATE_LIMIT_EXCEEDED
Für das Places SDK for Android gilt das Preismodell „Pay as you go“. „Places SDK for Android“-Anfragen für das Places SDK for Android werden nach SKU abgerechnet. Neben den Nutzungsbedingungen von Google gelten bestimmte Nutzungslimits für das Places SDK for Android. Verwalten Sie Ihre Kosten und Nutzung mit den Tools in der Google Cloud Console.
Abrechnung für das Places SDK for Android
Das Places SDK for Android verwendet 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:
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 das Places SDK for Android
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:
- Den „Place Autocomplete“-Dienst der Places API oder den „Places Autocomplete“-Dienst der Maps JavaScript API. Ihre Anwendung muss so konzipiert sein, dass Sitzungstokens bereitgestellt werden. Dazu sind unter Umständen Codeänderungen erforderlich.
- Das Widget „Autocomplete“ der Maps JavaScript API. In diesen Widgets wird die sitzungsbasierte Abrechnung automatisch aktiviert, ohne dass eine Änderung des Codes erforderlich ist.
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()
oderfindCurrentPlace()
- iOS: jeden Aufruf von
fetchPlaceFromPlaceID:
oderfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- 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.
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 eins 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
oderPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
-
iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinesssStatus
,GMSPlaceFieldID
,GMSPlaceFieldCoordinate
,GMSPlaceFieldName
,GMSPlaceFieldPhotos
,GMSPlaceFieldPlusCode
,GMSPlaceFieldTypes
oderGMSPlaceFieldViewport
-
Webdienst:
address_component
,adr_address
,business_status
,formatted_address
,geometry
,icon
,name
,permanently_closed
,photo
,place_id
,plus_code
,type
,url
,utc_offset
,vicinity
oderwheelchair_accessible_entrance
MONATLICHES NUTZUNGSVOLUMEN (Preis pro AUFRUF) |
||
---|---|---|
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.Field
s 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 eins der folgenden Felder angefragt wird:
-
Android:
Place.Field.CURRENT_OPENING_HOURS
,Place.Field.OPENING_HOURS
,Place.Field.PHONE_NUMBER
,Place.Field.SECONDARY_OPENING_HOURS
oderPlace.Field.WEBSITE_URI
-
iOS:
GMSPlaceFieldOpeningHours
,GMSPlaceFieldPhoneNumber
oderGMSPlaceFieldWebsite
-
Webdienst:
formatted_phone_number
,international_phone_number
,opening_hours
,current_opening_hours
,secondary_opening_hours
oderwebsite
MONATLICHES NUTZUNGSVOLUMEN (Preis pro AUFRUF) |
||
---|---|---|
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
oderPlace.Field.USER_RATINGS_TOTAL
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
oderGMSPlaceFieldServesVegetarianFood
- 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
oderuser_ratings_total
.
MONATLICHES NUTZUNGSVOLUMEN (Preis pro AUFRUF) |
||
---|---|---|
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:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: „Place Autocomplete“-Dienst der Maps JavaScript API
- Webdienst: „Place Autocomplete“-Dienst der Places API
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 (Preis pro ANFRAGE) |
||
---|---|---|
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 (Preis pro SITZUNG) |
||
---|---|---|
Jeweils 0,017 $ (17,00 $ pro 1.000) |
Jeweils 0,0136 $ (13,60 $ pro 1.000) |
Wegen Mengenrabatten bitte das Vertriebsteam kontaktieren |
Beispiel
Wenn Ihre Anwendung die folgenden zwei Aufrufe in einer einzelnen Sitzung ausgibt:
Android
- findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" …
Webdienst
- „Place Autocomplete“-Anfrage (input=”par”, session_token: XYZ)
- „Place Autocomplete“-Anfrage (input=”paris”, session_token: XYZ)
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 (Preis pro SITZUNG) |
||
---|---|---|
0,00 $ | 0,00 $ | 0,00 $ |
Beispiel
Wenn Ihre Anwendung die folgenden drei Aufrufe in einer einzelnen Sitzung ausgibt:
Android
- findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
- fetchPlace() (mit
FetchPlaceRequest
einschließlich der Place ID und des Adressfelds)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID: (einschließlich der Place ID und des Felds
GMSPlaceFieldFormattedAddress
)
Webdienst
- „Places Autocomplete“-Anfrage (input="par", session_token: XYZ)
- „Places Autocomplete“-Anfrage (input="paris", session_token: XYZ)
- Places Details (place_id, session_token: XYZ, fields:formatted_address)
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: Place Details
Für „Place Details“-Aufrufe fallen folgende Kosten an:
MONATLICHES NUTZUNGSVOLUMEN (Preis pro AUFRUF) |
||
---|---|---|
Jeweils 0,017 $ (17,00 $ pro 1.000) |
Jeweils 0,0136 $ (13,60 $ pro 1.000) |
Wegen Mengenrabatten bitte das Vertriebsteam kontaktieren |
Die SKU Place Details wird aus den folgenden APIs generiert:
- Android: Places SDK for Android
(
fetchPlace()
) - iOS: Places SDK for iOS
(
fetchPlaceFromPlaceID:
) - JavaScript: „Place Details“-Dienst der Maps JavaScript API (
getDetails
) - JavaScript: „Place Autocomplete“-Widget der Maps JavaScript API (
getPlace
) - JavaScript:
Place SearchBox-Widget der Maps JavaScript API:
getPlaces()
Nachdem ein Nutzer ein Ortsergebnis (Symbol: Pin) ausgewählt hat, *keine* Abfrage (Symbol: Lupe), wie hier dargestellt:Wenn Sie in den Suchergebnissen das Feld „Pizza“ in das Suchfeld eingeben, beachten Sie, dass Pizza Autentico ein Stecknadelsymbol daneben hat, . das steht für ein Ergebnis.“ - Webdienst: „Place Details“-Dienst der Places API
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
- Gehen Sie so vor:
- Mobilgerät: Rufen Sie
fetchPlace()
(Android) oderfetchPlaceFromPlaceID:
(iOS) auf und geben Sie nur das FeldADDRESS
an. - Web-API oder Webdienst: Stellen Sie eine „Place Details“-Anfrage und geben Sie nur das Adressfeld an –
getPlaceDetails(fields: formatted_address)
.
- Place Details (ab 0,017 $ pro Sitzung)
- Basic Data (0,00 $)
- Mobilgerät: Rufen Sie
- Gehen Sie so vor:
- Mobilgerät: Rufen Sie
fetchPlace()
(Android) oderfetchPlaceFromPlaceID:
(iOS) auf und geben Sie nur das FeldPHONE_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)
.
- Place Details (ab 0,017 $ pro Sitzung)
- Contact Data (ab 0,003 $ pro Anfrage)
- Mobilgerät: Rufen Sie
- Gehen Sie so vor:
- Mobilgerät: Rufen Sie
fetchPlace()
(Android) oderfetchPlaceFromPlaceID:
(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()
.
- 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)
- Mobilgerät: Rufen Sie
SKU: Find Current Place
Find Current Place wird für findCurrentPlace()
-Aufrufe (Android) und findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
-Aufrufe (iOS) berechnet.
MONATLICHES NUTZUNGSVOLUMEN (Preis pro AUFRUF) |
||
---|---|---|
Jeweils 0,03 $ (30,00 $ pro 1.000) |
Jeweils 0,024 $ (24,00 $ pro 1.000) |
Wegen Mengenrabatten bitte das Vertriebsteam kontaktieren |
Durch findCurrentPlace()
-Aufrufe (Android) oder findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
-Aufrufe (iOS) werden je nach den Feldern, die im Aufruf angegeben wurden, auch Daten-SKUs (Basic, Contact und/oder Atmosphere) generiert.
Geben Sie Datenfelder an, wenn die Antwort auf diese Felder beschränkt werden soll. Ihnen werden sowohl der „Find Current Place“-Aufruf als auch die angefragten Daten in Rechnung gestellt.
Beispiele
- Sie rufen
findCurrentPlace()
(Android) oderfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) auf und geben nur das FeldADDRESS
an. Auf Ihrer Rechnung werden die folgenden SKUs ausgewiesen (wenn Sie die Rechnung nach SKU filtern):- Find Current Place (ab 0,03 $ pro Anfrage)
- Basic Data (0,00 $)
- Sie rufen
findCurrentPlace()
(Android) oderfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) auf und geben das FeldPHONE_NUMBER
an. Auf Ihrer Rechnung werden die folgenden SKUs ausgewiesen (wenn Sie die Rechnung nach SKU filtern):- Find Current Place (ab 0,03 $ pro Anfrage)
- Contact Data (ab 0,003 $ pro Anfrage)
- Sie rufen
findCurrentPlace()
(Android) oderfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) auf und geben Felder für alle drei Daten-Buckets an: Auf Ihrer Rechnung werden die folgenden SKUs ausgewiesen (wenn Sie die Rechnung nach SKU filtern):- Find Current Place (ab 0,03 $ pro Anfrage)
- 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:
- Android:
fetchPhoto()
-Aufrufe - iOS:
loadPlacePhoto:
-Aufrufe - JavaScript: Anfragen an den „Place Photos“-Dienst der Places Library, Maps JavaScript API, wenn Daten von den durch
PlacePhoto.getUrl()
zurückgegebenen URLs angefragt werden, um Bild-Pixel-Daten zu laden - Webdienst: Anfragen an den „Place Photo“-Dienst der Places API
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 (Preis pro AUFRUF) |
||
---|---|---|
Jeweils 0,007 $ (7,00 $ pro 1.000) |
Jeweils 0,0056 $ (5,60 $ pro 1.000) |
Zu Mengenrabatten bitte das Vertriebsteam kontaktieren |
Nutzungsbedingungen – Einschränkungen
Entsprechende Informationen sind in den Nutzungsbedingungen für die Google Maps Platform im Abschnitt zu Lizenzbeschränkungen verfügbar.
Nutzungskosten verwalten
Legen Sie tägliche Kontingentlimits für alle Anfragen an eine API fest, um Ihre Nutzungskosten für das Places SDK for Android zu verwalten oder die Anforderungen Ihres Produktionstraffics zu erfüllen. Die Tageskontingente werden um Mitternacht Pacific Time (UTC -7/-8) zurückgesetzt.
Kontingentlimits für das Places SDK for Android ansehen oder ändern:
- Öffnen Sie in der Cloud Console die Google Maps Platform-Seite „Kontingente“.
- Klicken Sie auf das Drop-down-Menü „APIs“ und wählen Sie das Places SDK for Android aus.
- Scrollen Sie nach unten zur Karte Anfragen, um die Kontingentlimits zu sehen.
In einer Tabelle sind die Kontingentnamen und ‑limits aufgeführt. - 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.
Weitere Informationen zum Kostenmanagement
- Google Maps Platform – Abrechnung und Preisgestaltung
- Google Maps Platform – Berichterstellung und Monitoring
-
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. ↩