문제가 발생하면 Street View Static API에서 오류나 경고가 표시될 수 있습니다. 이 가이드에서는 각 오류 메시지를 설명하고 오류를 해결하기 위한 추가 안내를 제공합니다.
잘못된 요청
요청이 잘못된 경우 Street View Static API가 HTTP 4xx 상태 코드와 문제를 설명하는 메시지를 반환합니다. 아래는 이러한 오류 상황의 예를 보여줍니다. 참고: 이 목록은 발생할 수 있는 오류의 전체 목록이 아닙니다. 구체적인 문제에 관한 자세한 내용은 API에서 반환하는 실제 오류 코드와 메시지를 확인하세요.
오류 상황의 예
상태 코드
요청에 잘못된 매개변수가 포함되어 있거나 필수 매개변수가 누락되었습니다. 예를 들어 size 매개변수가 숫자 값의 예상 범위를 벗어났거나, 요청에서 누락되었습니다.
400 BAD REQUEST
요청에 포함된 API 키가 잘못되었습니다.
403 FORBIDDEN
스트리트 뷰 이미지가 표시되지 못하게 하는 오류
요청은 유효하지만 스트리트 뷰 이미지가 표시되지 않는 다른 오류가 발생하면 Street View Static API는 오류에 따라 스트리트 뷰 이미지 대신 텍스트 또는 오류 이미지를 반환합니다. 이러한 오류 조건의 예로는 애플리케이션이 사용량 한도를 초과하는 경우를 들 수 있습니다.
그림: 스트리트 뷰 이미지 대신 표시된 오류 이미지
API 키 및 결제 관련 오류
API 키 없이 Street View Static API를 사용하거나 계정에 결제가 사용 설정되지 않은 경우 페이지에 스트리트 뷰 이미지 대신 오류 이미지와 오류 유형을 나타내는 링크가 표시됩니다. 예: 'g.co/streetviewerror/key'
키 없는 오류 및 해결 방법
API 키 없이 Street View Static API를 사용하고 있습니다. 이 문제를 해결하려면 다음을 수행해야 합니다.
[null,null,["최종 업데이트: 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) |"]]
