Fehler beheben
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Hier finden Sie einige Tipps zur Fehlerbehebung bei häufig auftretenden Problemen.
Warum ist der Genauigkeitsradius so groß?
Wenn in Ihrer Geolocation-Antwort im Feld „accuracy“ ein sehr hoher Wert angezeigt wird, wird der Standort möglicherweise anhand der IP-Adresse der Anfrage statt anhand von WLAN-Punkten oder Mobilfunkmasten ermittelt. Diese Art von Antworten kann auftreten, wenn der Dienst keine Mobilfunkmasten oder Zugriffspunkte erkennt.
Wenn Sie bestätigen möchten, dass der Dienst Ihre Zugriffspunkte nicht geolokalisieren konnte, setzen Sie considerIp
in Ihrer Anfrage auf „false“. Wenn die Antwort „404“ lautet, haben Sie bestätigt, dass die Objekte „wifiAccessPoints“ und „cellTowers“ nicht geolokalisiert werden konnten.
Wie behebe ich einen Antwortfehler?
Wenn bei Ihrer Anfrage ein Fehler auftritt, gibt das System einen Antworttext im Standardformat zurück und legt den HTTP-Statuscode auf einen Fehlerstatus fest.
Die Fehlerantwort enthält ein Objekt mit einem einzelnen Fehlerobjekt mit den folgenden Schlüsseln:
code
: Dies entspricht dem HTTP-Status der Antwort.
message
: Eine kurze Beschreibung des Fehlers.
errors
: Eine Liste der aufgetretenen Fehler. Jeder Fehler enthält eine Kennung für den Fehlertyp (den Grund) und eine kurze Beschreibung (die Meldung).
Wenn Sie beispielsweise ungültiges JSON senden, wird der folgende Fehler zurückgegeben:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "parseError",
"message": "Parse Error",
}
],
"code": 400,
"message": "Parse Error"
}
}
Für zusätzliche Tests können Sie mit den folgenden SDKs und APIs Informationen von Ihrem Gerät erfassen:
Fehlerbeschreibungen
Im Folgenden finden Sie eine Beschreibung der möglichen Fehler.
Grund |
Domain |
HTTP-Statuscode |
Beschreibung |
dailyLimitExceeded |
usageLimits |
403 |
Sie haben Ihr Tageslimit überschritten. |
keyInvalid |
usageLimits |
400 |
Ihr API-Schlüssel ist für die Geolocation API nicht gültig. Achten Sie darauf, dass Sie den gesamten Schlüssel angeben und die API entweder gekauft oder die Abrechnung aktiviert und die API aktiviert haben, um das Kontingent kostenlos zu erhalten. |
userRateLimitExceeded |
usageLimits |
403 |
Sie haben das in der Google Cloud Console konfigurierte Anfragelimit überschritten.
Dieses Limit wird in der Regel als Anfragen pro Tag, Anfragen pro 100 Sekunden und Anfragen pro 100 Sekunden und Nutzer festgelegt. Sie sollten Ihr Limit so konfigurieren, dass nicht ein einzelner Nutzer oder eine kleine Gruppe von Nutzern Ihr Tageskontingent aufbrauchen, aber alle Nutzer trotzdem angemessenen Zugriff haben.
Informationen zum Konfigurieren dieser Limits finden Sie unter API-Nutzung deckeln.
|
notFound |
geolocation |
404 |
Die Anforderung war gültig, aber es wurden keine Ergebnisse zurückgegeben. |
parseError |
global |
400 |
Der Anforderungstext weist nicht das gültige JSON-Format auf. Weitere Informationen zu den einzelnen Feldern finden Sie im Abschnitt Anfragetext. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-09-03 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-09-03 (UTC)."],[[["\u003cp\u003eThe Geolocation API uses IP addresses, WiFi points, and cell towers to determine location, with large accuracy radius often indicating IP-based geolocation.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshooting involves examining the error response, which includes an error code, message, and a list of errors with reasons and descriptions.\u003c/p\u003e\n"],["\u003cp\u003eYou can gather additional testing information from devices using the Android Location APIs, Places SDK for Android and iOS.\u003c/p\u003e\n"],["\u003cp\u003ePossible errors include exceeding daily or user request limits, using an invalid API key, and requests returning no results despite being valid.\u003c/p\u003e\n"]]],["If a large accuracy radius is shown, the service may be using the request IP instead of cell towers or WiFi. Test by setting `considerIp` to false; a 404 response confirms no access points were found. Error responses include a `code` (HTTP status), `message`, and an `errors` list with `reason` and `message`. Common errors include `dailyLimitExceeded` (403), `keyInvalid` (400), `userRateLimitExceeded` (403), `notFound` (404), and `parseError` (400) due to invalid JSON.\n"],null,["# Troubleshoot\n\nHere are some tips on troubleshooting common issues.\n\nWhy is the accuracy radius very large?\n--------------------------------------\n\nIf your Geolocation response shows a very high value in the accuracy field, the\nservice may be geolocating based on the request IP, instead of WiFi points or\ncell towers. These kinds of responses can happen if the service does not\nrecognize any cell towers or access points.\n\nTo confirm that the service could not geolocate your access points, set\n`considerIp` to false in your request. If the response is a 404, you've\nconfirmed that your wifiAccessPoints and cellTowers objects could not be geolocated.\n\nHow do I troubleshoot a response error?\n---------------------------------------\n\nIf your request generates an error, the system returns a standard format error\nresponse body and sets the HTTP status code to an error status.\n\nThe error response contains an object with a single error object with the\nfollowing keys:\n\n- `code`: This is the same as the HTTP status of the response.\n- `message`: A short description of the error.\n- `errors`: A list of errors that occurred. Each error contains an identifier for the type of error (the reason) and a short description (the message).\n\nFor example, sending invalid JSON returns the following error: \n\n {\n \"error\": {\n \"errors\": [\n {\n \"domain\": \"global\",\n \"reason\": \"parseError\",\n \"message\": \"Parse Error\",\n }\n ],\n \"code\": 400,\n \"message\": \"Parse Error\"\n }\n }\n\nGather testing information from devices\n---------------------------------------\n\nFor additional testing, you can gather information from your device using the\nfollowing SDKs and APIs:\n\n- **Android devices** : Go to [Places SDK for Android](/maps/documentation/places/android-sdk/current-place), and [Android\n Location APIs](https://developer.android.com/training/location/index.html).\n\n- **iOS devices** : Go to [Places SDK for iOS](/maps/documentation/places/ios-sdk/current-place).\n\nError descriptions\n------------------\n\nHere are the possible errors you might encounter with descriptions.\n\n| Reason | Domain | HTTP Status Code | Description |\n|-------------------------|---------------|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `dailyLimitExceeded` | `usageLimits` | 403 | You have exceeded your [daily limit](/maps/documentation/geolocation/usage-and-billing#other-usage-limits). |\n| `keyInvalid` | `usageLimits` | 400 | Your API key is not valid for the Geolocation API. Be sure to include the entire key, and that you've either purchased the API or have [enabled billing and activated the API](/maps/documentation/geolocation/get-api-key) to obtain the quota at no charge. |\n| `userRateLimitExceeded` | `usageLimits` | 403 | You have exceeded the request limit that you configured in the Google Cloud console. This limit is typically set as requests per day, requests per 100 seconds, and requests per 100 seconds per user. You should configure your limit to prevent a single or small group of users from exhausting your daily quota, while still allowing reasonable access to all users. See [Capping API Usage](https://cloud.google.com/apis/docs/capping-api-usage) to configure these limits. |\n| `notFound` | `geolocation` | 404 | The request was valid, but no results were returned. |\n| `parseError` | `global` | 400 | The request body is not valid JSON. Refer to the [Request Body](/maps/documentation/geolocation/requests-geolocation#body) section for details on each field. |"]]