iNavi Maps Static Map API Reference

Restful API 기반 Static Map API 를 사용하는 방법을 설명 합니다.

iNavi Maps API 를 사용하기 위해서는 Appkey 발급이 필요합니다.
Toast 사이트에서 ‘Maps’ 상품을 신청하여 AppKey 발급을 받으면 iNavi Maps API 를 사용 하실 수 있습니다.

자세한 사항은 Toast Maps 상품안내 를 참고해주세요.

Static Map 직접 해보기

사용자가 지정한 지도 범위에 대해 정적 지도 이미지 URL을 반환합니다.

  • Request URL

    Http Method URL
    GET https://api-maps.cloud.toast.com/maps/v3.0/appkeys/{appkey}/static-maps
  • Request Path Parameter

    타입 설명
    appKey String 고유의 appKey
  • Request Query Parameter

    타입 필수 설명
    lon String O 요청할 Long(경도)좌표
    lat String O 요청할 Lat(위도)좌표
    width String X 요청할 이미지 width값 ex) 400px x2 값을 입력한 경우, width X 2 (max-width : 1000px)
    height String X 요청할 이미지 height값 ex) 400px x2 값을 입력한 경우, height X 2 (max-height : 1000px)
    zoom String X 요청할 좌표의 확대레벨 default : 14
    bearing String X 요청할 좌표의 회전율 (0 - 359) default : 0
    pitch String X 요청할 좌표의 기울기 (0 - 60) default : 0
    x2 String X 사이즈 2배 반환 여부
    • x2값을 입력한 경우, 2배 반환 ex) x2 = 1
    • x2값을 입력하지 않은 경우, 정사이즈 반환
    mx String X 마커를 표현할 좌표(lon, imgUrl 값이 있으면 반환)
    my String X 마커를 표현할 좌표(lat, imgUrl 값이 있으면 반환)
    imgUrl String X 마커를 표현할 이미지 URL ex) https://www.fivepin.co.kr/resources/images/MyStory/marker_plog_around_center.png
  • Response Field (Fail)

    타입 설명
    header (Object) isSuccessful Boolean 성공여부
    resultCode Integer 실패 코드
    resultMessage String 실패 메시지
    result (Object) url String StaticMap URL
  • Response Static Map (Success)

    예시)

    staticmap

    zoom (지도 확대 레벨) = 14, bearing (좌표의 회전율) = 112, pitch (좌표의 기울기) = 60, width (지도 width) = 1000, height (지도 height) = 600


결과코드

결과 코드값 리스트

  • 결과코드

    resultCode resultMessage 비고 설명
    0 공통 성공
    100 Result Not Found 검색전용 결과없음
    101 Argument Error 공통 파라미터 오류
    102 Internal Server Error 검색전용 서버 오류
    201 Searching for Security 검색전용 POI 보안시설물
    202 Longitude/Latitude 검색전용 경위도
    203 Mobile Phone Number 검색전용 전화번호(Mobile)
    204 Invalid Query 검색전용 서버 오류
    205 POI not in given Admin 검색전용 결과없음(지역설정)
    206 POI not in given Area 검색전용 결과없음(영역설정)
    207 POI not in given Category 검색전용 결과없음(분류설정)
    208 Neighbor Search Only 검색전용 결과없음(주변검색만입력)
    209 Neighbor Search not Found 검색전용 결과없음(주변 + 키워드 검색 결과 없음)
    300 AppKey Error 공통 AppKey 인증 오류

×
Request Parameters
Result