[Rush-Logistic-1472] Naver Map API 사용 방법 - 준비

준비

1. 회원 가입 및 로그인

네이버 클라우드 API 콘솔에서 회원가입 및 로그인 진행

2. 메인 Home에서 우측 상단 '콘솔'을 클릭해 콘솔 화면으로 이동

3. 좌측 배너에서 'AI NAVER API'선택 후 Application 등록

Application 이름

• 추후 콘솔에서 App 이름으로 관리
• 자유롭게 설정

Service 선택

• 네이버 지도 API -> Maps 공식문서
  • Web Dynamic Map 공식문서
    • JavaScript형태의 네이버 지도 플랫폼
    • 사용자 웹 서비스 또는 애플리케이션에 네이버 지도 기능을 구현할 수 있도록 다양한 클래스와 라이브러리를 제공합니다.
  • Mobile Dynamic Map
    • Android 공식문서
      • 네이버 지도 Android 개발 도구
      • Android 운영체제의 모바일 환경에서 네이버 지도를 사용할 수 있도록 다양한 클래스와 메소드를 제공합니다.
    • Ios 공식문서
      • 네이버 지도 iOS 개발 도구
      • iOS 운영체제의 모바일 환경에서 네이버 지도를 사용할 수 있도록 다양한 클래스와 메서드를 제공합니다.
    • Static Map 공식문서
      • Static Map API는 REST 형식을 따르는 네이버 지도 인터페이스
      • HTTP GET 메소드를 이용하여 네이버 지도 이미지를 받을 수 있습니다.
  • Directions
  • Directions 5 공식문서
    • REST 형식을 따르는 네이버 지도 인터페이스
    • HTTP GET 메소드를 이용하여 출발지-목적지 간의 경로 정보를 요청하고 응답으로 경로 데이터 배열을 반환 받습니다.
    • Directions 5 API는 경유지를 5개까지 입력할 수 있습니다.
    • Direction 5 API가 제공하는 경로 정보는 자동차에 한해서만 제공됩니다.
      • 차량 옵션은 있으나 톨게이트 요금 계산에 활용
    • 경로를 구하기 위한 다양한 옵션을 query로 지정 가능
  • Directions 15 공식문서
    • REST 형식을 따르는 네이버 지도 인터페이스
    • HTTP GET 메서드를 이용하여 출발지-목적지 간의 경로 정보를 요청하고 응답으로 경로 데이터 배열을 반환 받습니다.
    • Directions 15 API는 경유지를 15개까지 입력할 수 있습니다.
    • Directions 15 API가 제공하는 경로 정보는 자동차에 한해서만 제공됩니다.
  • Geocoding
    • Geocoding 공식문서
      • REST 형식을 따르는 네이버 지도 인터페이스
      • HTTP GET 메소드를 이용하여 지번 도로명을 좌표값으로 반환 받는 API입니다.
      • 주소문자열 -> 좌표 String Type 위도, 경도
    • Reverse Geocoding 공식문서
      • REST 형식을 따르는 네이버 지도 인터페이스
      • HTTP GET 메소드를 이용하여 지도 좌표값을 주소 정보(지번, 도로명, 법정동, 행정동)으로 반환 받는 API입니다.
      • 좌표 String Type 위도, 경도 -> 주소문자열

서비스 환경 등록

• 필요하다면 작성
• API 요청을 허용할 host를 지정

4. 인증 키 발급

• App 이름의 '인증 정보' 클릭

• 추후 네이버 지도 API로 요청시 Request Header에 담아야 함
  • Header 필드
    • x-ncp-apigw-api-key-id : 클라이언트 ID
    • x-ncp-apigw-api-key : Secret Key

 

---

이후 예제는 Geocoding, Directions 5 API에 대해 작성되었습니다.
Geocoding과 Reverse Geocoding은 좌표<->주소간 변환하며 비슷한 면이 있습니다.
Directions 5와 Directions 15는 최대 경유지 갯수의 차이와 API 요청방법에 대한 차이가 있습니다.

Reverse Geocoding과 Directions 15를 사용하실 분은
참고하시되 "공식 문서"를 확인하시기 바랍니다.