Static Map 개요
    • PDF

    Static Map 개요

    • PDF

    Article Summary

    요청된 URL 매개변수를 기반으로 웹 페이지에 표시할 수 있는 이미지로 지도를 반환합니다.

    공통 설정

    클라이언트 아이디는 NAVER Cloud Platform 콘솔에서 애플리케이션을 등록해 발급받습니다.

    1. 콘솔의 AI·NAVER API > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >

    2. AI·NAVER API > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.

    3. AI·NAVER API > AI·NAVER API > Application변경 화면에서 Static Map가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.

    API URL

    메서드요청 URI응답 형식인증 방식
    GEThttps://naveropenapi.apigw.ntruss.com/map-static/v2/rasterBinary(PNG/JPG 이미지 형식)ID-KEY 인증
    GEThttps://naveropenapi.apigw.ntruss.com/map-static/v2/raster-corsBinary(PNG/JPG 이미지 형식)HTTP Referer 인증

    요청 헤더

    헤더명설명
    X-NCP-APIGW-API-KEY-ID앱 등록 시 발급받은 Client ID
    X-NCP-APIGW-API-KEY-ID:{Client ID}
    X-NCP-APIGW-API-KEY앱 등록 시 발급 받은 Client Secret
    X-NCP-APIGW-API-KEY:{Client Secret}

    오류 코드

    {
      "error": {
        "errorCode": "300",
        "message": "Not Found Exception"
      }
    }
    

    공통 오류

    HttpStatusCodeErrorCodeErrorMessageDescription
    400100Bad Request Exceptionprotocol(https), endocing(UTF-8) 등 request 오류
    401200Authentication Failed인증실패
    401210Permission Denied권한없음
    404300Not Found Exception권한없음
    429400Quota ExceededQuota 초과
    429410Throttle LimitedRate 초과
    429420Rate LimitedRate 초과
    413430Request Entity Too Largecontent-length 초과 (10MB)
    503500Endpoint Error엔드포인트 연결오류
    504510Endpoint Timeout엔드포인트 연결시간 초과
    500900Unexpected Error예외처리가 안된 오류

    API 오류

    HttpStatusCodeErrorCodeErrorMessageDescription
    400100Bad request요청에 유효하지 않은 파라미터가 있음을 나타냄
    500900Internal error서버 내부에 오류가 발생했음 의미
    지속적으로 문제 발생 시 공식 문의 채널 확인 요망
    503500Service Unavailable시스템 유지보수로 인해 일시적인 응답 불가 상태
    잠시 후 재시도 필요
    504510Gateway Timeout시스템 과부하로 인해 일시적인 응답 불가 상태
    잠시 후 재시도 필요

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.