Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Maps Static API의 오류 메시지

요청이 실패하면 Maps Static API에서 오류 또는 경고를 발행합니다. 이 가이드에서는 오류 메시지를 설명하고 오류를 해결하는 방법을 안내합니다.

잘못된 요청

잘못된 요청의 경우 Maps Static API는 다음 목록에 표시된 것처럼 HTTP 4xx 상태 코드와 문제를 설명하는 메시지를 반환합니다. 특정 문제에 관한 자세한 내용은 API에서 반환된 실제 오류 코드와 메시지를 확인하세요.

요청에 잘못된 매개변수가 포함되어 있거나 필수 매개변수가 누락되었습니다. 예를 들어 size 매개변수가 예상되는 숫자 값 범위 내에 없거나 요청에서 누락되었습니다.: 400 BAD REQUEST
요청에 포함된 API 키가 잘못되었습니다.: 403 FORBIDDEN

요청이 유효하지만 지도가 표시되지 않는 다른 오류가 발생하면 Maps Static API는 지도 대신 텍스트나 오류 이미지를 반환합니다. 예를 들어 애플리케이션이 사용량 한도를 초과하면 오류가 발생합니다.

API 키 없이 Maps Static API를 사용하거나 계정에서 결제가 사용 설정되지 않은 경우 페이지에 지도 대신 오류 이미지가 표시되며 오류 유형을 나타내는 링크가 표시됩니다. 예를 들어 'g.co/staticmaperror/key'입니다.

키리스 오류 및 해결 방법
	API 키 없이 Maps Static API를 사용하고 있습니다. 이 오류를 해결하려면 다음 단계를 완료하세요. API 키 가져오기 결제 사용 설정 URL 서명하기
	요청에 필수 디지털 서명이 누락되었습니다. 이 오류를 해결하려면 URL에 서명하세요.

일부 오류 조건의 경우 API는 지도를 반환하지만 지도에서 일부 정보가 누락될 수 있습니다. 이 경우 다음 조건을 사용하여 경고를 식별할 수 있습니다.

예를 들어 다음 URL의 markers 매개변수에는 예상치 못한 값이 포함되어 있습니다.

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY

API는 지도를 반환하지만 이미지에 '지도 오류: g.co/staticmaperror'라는 텍스트가 있는 노란색 오류 막대가 중첩되어 표시됩니다.

이 API는 또한 다음과 같은 HTTP 헤더를 반환합니다.

X-Staticmap-API-Warning:Error geocoding: marker 1

다음 표에서는 API가 HTTP 헤더로 발행할 수 있는 경고를 설명합니다.

`X-Staticmap-API-Warning` 헤더의 경고
`Error geocoding: [center, ][marker #number, ][visible #num, ][path #num, ]*`	요청을 지오코딩하려는 중에 오류가 발생했습니다. 지오코딩이 실패한 요소(예: `center`, `marker`, `visible`, `path`)와 실패한 요소의 수에 따라 이 메시지의 변형이 많이 있습니다. 이 경고의 한 예는 앞의 예에 표시된 `X-Staticmap-API-Warning:Error geocoding: marker 1`입니다.
`Too many geocoded markers requested (max is 15).`	요청에 사람이 읽을 수 있는 주소가 있는 허용된 최대 마커 수보다 많은 마커가 지정되어 있습니다. 최대값은 15입니다. 이 제한은 지오코딩이 필요한 사람이 읽을 수 있는 주소로 지정된 마커에만 적용됩니다. 위도 및 경도 좌표로 지정된 마커에는 적용되지 않습니다.
`Too many geocoded polyline vertices requested (max is 15).`	요청에 사람이 읽을 수 있는 주소가 있는 허용된 최대 수의 폴리라인보다 많은 폴리라인이 지정되어 있습니다. 최대값은 15입니다. 이 제한은 지오코딩이 필요한 사람이 읽을 수 있는 주소로 지정된 꼭짓점이 있는 다중선에만 적용됩니다. 위도 및 경도 좌표로 지정된 다중선에는 적용되지 않습니다.

Chrome DevTools 콘솔, Firefox 웹 콘솔 또는 브라우저의 기타 이에 상응하는 도구에서 HTTP 헤더 경고를 확인할 수 있습니다.