Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Die Street View Static API kann bei Fehlern einen Fehler oder eine Warnung ausgeben. In diesem Leitfaden werden die einzelnen Fehlermeldungen erläutert und weitere Informationen zum Beheben von Fehlern gegeben.
Unzulässige Anforderungen
Bei einer ungültigen Anfrage gibt die Street View Static API den HTTP-Statuscode 4xx und eine Meldung zurück, in der das Problem beschrieben wird. Nachstehend finden Sie Beispiele für die Fehlerbedingungen. Hinweis: Dies ist keine vollständige Liste der möglichen Fehler. Prüfen Sie den tatsächlichen Fehlercode und die Meldung, die von der API zurückgegeben werden, um Details zu bestimmten Problemen zu erhalten.
Beispiel: Fehlerbedingung
Statuscode
Die Anfrage enthält einen ungültigen Parameter oder ein erforderlicher Parameter fehlt. Beispielsweise liegt der Parameter size nicht im erwarteten Bereich numerischer Werte oder fehlt in der Anfrage.
400 BAD REQUEST
Der in der Anforderung enthaltene API-Schlüssel ist ungültig.
403 FORBIDDEN
Fehler, die verhindern, dass ein Street View-Bild angezeigt wird
Wenn die Anfrage gültig ist, aber ein weiterer Fehler auftritt, der verhindert, dass das Street View-Bild angezeigt wird, gibt die Street View Static API je nach Fehler entweder Text oder ein Fehlerbild anstelle des Street View-Bilds zurück. Ein Beispiel für eine solche Fehlerbedingung tritt auf, wenn die Anwendung ihre Nutzungslimits überschreitet.
Abbildung: Anstelle eines Street View-Bilds wird ein Fehlerbild angezeigt
Fehler im Zusammenhang mit API-Schlüsseln und der Abrechnung
Wenn Sie die Street View Static API ohne API-Schlüssel verwenden oder die Abrechnung für Ihr Konto nicht aktiviert ist, wird auf der Seite anstelle eines Street View-Bildes ein Fehlerbild zusammen mit einem Link angezeigt, der den Fehlertyp angibt. Beispiel: „g.co/streetviewerror/key“.
Schlüssellose Fehler und Lösungen
Sie verwenden die Street View Static API ohne API-Schlüssel. So beheben Sie das Problem:
[null,null,["Zuletzt aktualisiert: 2025-08-29 (UTC)."],[[["\u003cp\u003eThis guide explains error messages returned by the Street View Static API and provides instructions for resolving them.\u003c/p\u003e\n"],["\u003cp\u003eInvalid requests result in a \u003ccode\u003e4xx\u003c/code\u003e status code with a descriptive message, such as errors related to parameters or invalid API keys.\u003c/p\u003e\n"],["\u003cp\u003eWhen a valid request cannot display a street view image due to issues like usage limits, either text or an error image is returned.\u003c/p\u003e\n"],["\u003cp\u003eUsing the API without a key or billing enabled leads to an error image with a link to further information and solutions.\u003c/p\u003e\n"]]],[],null,["# Error Messages in Street View Static API\n\nThe Street View Static API may issue an error or warning when something goes\nwrong. This guide explains each error message, and provides further\ninstructions for resolving errors.\n\nInvalid requests\n----------------\n\nIn the case of an invalid request, the Street View Static API returns\nan HTTP `4xx` status code and a message describing the\nproblem. Below are examples of such error conditions. Note: This is not\na complete list of the possible errors. Please check the actual error code\nand message returned by the API for details of specific problems.\n\n| Example of error condition | Status code |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|\n| The request includes an invalid parameter, or a required parameter is missing. For example, the `size` parameter is not within the expected range of numeric values, or is missing from the request. | `400 BAD REQUEST` |\n| The API key included in the request is invalid. | `403 FORBIDDEN` |\n\nErrors that prevent a street view image from being displayed\n------------------------------------------------------------\n\nIf the request is valid, but another error occurs that prevents the street view image from\nbeing displayed, the Street View Static API returns either text or an error\nimage instead of the street view image, depending on the error. An example of such an error\ncondition is when the application exceeds its\n[usage limits](/maps/documentation/streetview/usage-limits).\n\nFigure: An error image displayed instead of a street view image\n\n### Errors related to API keys and billing\n\nIf you use the Street View Static API without an API key, or if billing\nis not enabled on your account, the page displays an error image instead of a\nstreet view image, with a link indicating the type of error. For example\n\"g.co/streetviewerror/key\".\n\n| Keyless errors and solutions ||\n|---|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | You are using the Street View Static API without an API key. To resolve, you must: 1. [Get an API key](/maps/documentation/streetview/get-api-key#get-an-api-key) 2. [Enable billing](https://console.cloud.google.com/project/_/billing/enable?utm_source=Docs_BillingNudge) 3. [Sign your URL](/maps/documentation/streetview/get-api-key#digital-signature) |\n| | Your request is missing a digital signature (required). To resolve, [Sign your URL](/maps/documentation/streetview/get-api-key#digital-signature) |"]]
