Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La API de Street View Static puede generar un error o una advertencia cuando algo sale mal. En esta guía, se explica cada mensaje de error y se proporcionan instrucciones adicionales para resolverlos.
Solicitudes no válidas
En el caso de una solicitud no válida, la API de Street View Static muestra un código de estado HTTP 4xx y un mensaje que describe el problema. A continuación se muestran ejemplos de esas condiciones de error. Nota: Esta no es una lista completa de los posibles errores. Consulta el código de error y el mensaje reales que muestra la API para obtener detalles sobre problemas específicos.
A continuación se muestran ejemplos de esas condiciones de error.
Código de estado
La solicitud incluye un parámetro no válido o falta un parámetro obligatorio. Por ejemplo, el parámetro size no está dentro del rango de valores numéricos esperado o no está en la solicitud.
400 BAD REQUEST
La clave de API incluida en la solicitud no es válida.
403 FORBIDDEN
Errores que no permiten mostrar una imagen de Street View
Si la solicitud es válida, pero ocurre otro error que no permite que se muestre la imagen de Street View, la API de Street View Static muestra texto o una imagen de error en lugar de la imagen de Street View, según el error. Un ejemplo de una condición de error como esta es cuando la aplicación excede sus límites de uso.
Figura: Se muestra una imagen de error en lugar de una imagen de Street View
Errores relacionados con las claves de API y la facturación
Si usas la API de Street View Static sin una clave de API o si la facturación no está habilitada en tu cuenta, la página mostrará una imagen de error en lugar de una imagen de Street View, con un vínculo que indicará el tipo de error. Por ejemplo, "g.co/streetviewerror/key".
Errores y soluciones sin clave
Usas la API de Street View Static sin una clave de API. Para resolverlo, debes hacer lo siguiente:
[null,null,["Última actualización: 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) |"]]
