Error messages in Street View Static API

  • This guide explains error messages returned by the Street View Static API and provides instructions for resolving them.

  • Invalid requests result in a 4xx status code with a descriptive message, such as errors related to parameters or invalid API keys.

  • When a valid request cannot display a street view image due to issues like usage limits, either text or an error image is returned.

  • Using the API without a key or billing enabled leads to an error image with a link to further information and solutions.

When a request fails, the Street View Static API returns an error or warning. This guide explains the error messages and provides instructions for resolving them.

Invalid requests

For an invalid request, the Street View Static API returns an HTTP 4xx status code and a message describing the problem. The following table lists examples of such error conditions, though this isn't a complete list of possible errors. You can check the actual error code and message returned by the API for details of specific problems.

Example of error condition Status code
The request includes an invalid parameter, or a required parameter is missing. For example, the size parameter isn't within the expected range of numeric values, or is missing from the request. 400 BAD REQUEST
The API key included in the request is invalid. 403 FORBIDDEN

Errors that prevent a street view image from being displayed

If the request is valid, but another error occurs that prevents the street view image from being displayed, the Street View Static API returns either text or an error image instead of the street view image, depending on the error. An example of such an error condition is when the application exceeds its usage limits.

Error image displayed instead of a Street View image
Figure: An error image displayed instead of a street view image

If you use the Street View Static API without an API key, or if billing isn't enabled on your account, the page displays an error image instead of a street view image, with a link indicating the type of error. For example, "g.co/streetviewerror/key."

Keyless errors and solutions
Usage limits error: exceeded provided daily map loads limit You're using the Street View Static API without an API key. To resolve this error, complete the following steps:
  1. Get an API key
  2. Enable billing
  3. Sign your URL
Usage limits error: request URLs are missing the digital signature Your request is missing a required digital signature. To resolve this error, sign your URL.