EIS 이미지 서비스 API

API Key

하늘소프트의 전자해도 이미지 서비스를 사용하기 위해서는 API Key를 필수 인자로 반드시 지정하여야 합니다. API Key 발급 절차는 2026년 초에 오픈할 예정입니다.

API 파라미터

EIS API를 사용하여 전자해도를 요청하는 방식은 크게 두 가지입니다.

• 이미지 크기 기반 요청
• 타일맵 요청

창 크기만큼의 이미지를 요청할 때는 창의 크기와 동일한 크기로 이미지의 폭과 높이를 지정합니다. 요청 시에는 맵 요청 모드를 center 또는 area로 지정해주어야 합니다. 맵 요청 모드를 center로 했을 때는 지도의 축척을 나타내는 scale을 함께 지정하여야 합니다. 맵 요청 모드를 area로 했을 때는 지도의 경계를 나타내는 좌우 경도(left, right), 상하 위도(top, bottom)를 함께 지정해야 합니다. 타일맵 방식은 타일맵 제공 URL의 처리가 가능한 프레임워크와 함께 사용하여야 합니다. 타일맵 방식에서는 맵 요청 모드를 지정하는 것은 의미가 없습니다. Mode, scale, left, top, right, bottom 외에는 전자해도의 전시 방식을 지정하는 것으로 아래 표의 값들을 요청 인자로 사용해야 합니다.

이미지 크기 기반 요청 방법

이미지 크기로 전자해도 이미지를 요청할 때는 HTTP GET 또는 POST 방식을 사용할 수 있습니다.

GET 요청 방법

GET 방식으로 이미지를 요청할 때는 아래와 같은 URL 형식을 사용합니다.

          
https://eisapi.hanulsoft.co.kr?key={YOUR_API_KEY}&param1=value1&...&paramN=valueN
          
        

사용 예시 1: mode=center

          
https://eisapi.hanulsoft.co.kr/?key={YOUR_API_KEY}&mode=center&scale=10000000&lon=127&lat=35&width=1024&height=768
  
        

center 모드에서 GET 요청 결과

사용 예시 2: mode=area

          
https://eisapi.hanulsoft.co.kr/?key={YOUR_API_KEY}&mode=area&left=110&right=140&top=36&bottom=34&width=1024&height=768
          
        

area 모드에서 GET 요청 결과

POST 요청 방법

POST 요청은 GET 방식과 유사하지만, 인자를 POST 요청의 Body에 기록하여 URL에서 인자를 노출시키지 않는 방식입니다.

POST 방식으로 이미지를 요청할 때는 아래와 같은 EIS API의 URL만 지정하고 인자는 요청 메시지 바디에 따로 넣도록 합니다.

사용 예시 1: mode=center

POST URL: https://eisapi.hanulsoft.co.kr

          
{
  "key" : "{YOUR_API_KEY}",
  "mode": "center",
  "scale": 10000000,
  "lon": 127,
  "lat": 35,
  "width": 1024,
  "height":768
}
          
        

center 모드에서 POST 요청 결과

사용 예시 2: mode=area

POST URL: https://eisapi.hanulsoft.co.kr

          
{
  "key" : "{YOUR_API_KEY}",
  "mode": "area",
  "left": 110,
  "right": 140,
  "top": 36,
  "bottom": 34,
  "width": 1024,
  "height":768
}
          
        

area 모드에서 POST 요청 결과

타일맵 요청 방법

타일맵은 OpenLayers나 leaflet처럼 타일맵 URL을 받아서 처리할 수 있는 프레임워크와 함께 사용할 수 있습니다. 타일맵 요청에는 지도의 확대/축소값 z, 가로 타일의 인덱스 x, 세로 타일의 인덱스 y를 지정된 형식의 URL에 지정해야 합니다. 타일맵 요청은 GET 방식만 받아들일 수 있으므로, API Key 및 다른 인자들을 쿼리 스트링 형식으로 타일맵 URL에 추가해주면 됩니다.

하늘소프트 EIS 타일맵 URL

          
https://eisapi.hanulsoft.co.kr/tilemap/{z}/{x}/{y}.png?key={YOUR_API_KEY}&param1=value1&...&paramN=valueN
          
        

Leaflet을 사용한 예시

          
// 맵 초기화
let map = L.map("map").setView([34.8808, 128.622], 10); // 거제도, 대한민국

const ENC_SERVER_URL = "https://eisapi.hanulsoft.co.kr";
const my_api_key = "{YOUR_API_KEY}";
const urlTemplate = `${ENC_SERVER_URL}/tilemap/{z}/{x}/{y}.png?key={my_api_key}&text=0&symbol=0`;

let tileLayer = L.tileLayer(urlTemplate, {
  attribution: "© Hanulsoft ENC",
  maxZoom: 18
}).addTo(map);
          
        

위 코드는 Leaflet을 사용하여 지도를 초기화하고, API로부터 타일 이미지를 가져와 지도에 표시하는 예시입니다. API 키와 요청 파라미터를 적절히 설정해야 합니다.