30
T map API 활용 소개 2017.07

T map API 활용소개 - api.visitkorea.or.krapi.visitkorea.or.kr/event1/file/TmapAPI_Guide.pdf · T map Services lB2C-T map Navigation-T map 대중교통-T map 택시 lB2B-T map

  • Upload
    phamdat

  • View
    245

  • Download
    5

Embed Size (px)

Citation preview

T map API 활용 소개

2017.07

T map Services

l B2C

- T map Navigation

- T map 대중교통

- T map 택시

l B2B

- T map for Biz. : T map API, T map Contents, T map

Data

- T map for Car : 르노삼성, 쌍용, 기아, 재규어 랜드로버2

l B2C

- T map Navigation

- T map 대중교통

- T map 택시

l B2B

- T map for Biz. : T map API, T map Contents, T map

Data

- T map for Car : 르노삼성, 쌍용, 기아, 재규어 랜드로버

T map for Biz. 4대 Component

3

T map API 제공

4

T map API 제공

5

T map API API 이용의 기본 개념

https://developers.skplanetx.com/apidoc/kor/tmap/reference/

T map API 첫걸음

1)좌표계 : EPSG, WGS84, KATECH

2)Zoom Level : Level 0 (넓은지역) çè Level 19(좁은 지역)

3)Geocoding / ReverseGeocoding

4)POI(Point Of Interest)

5)GeoJSON / KML

6)Image Map / Vector Map

6

1)좌표계 : EPSG, WGS84, KATECH

2)Zoom Level : Level 0 (넓은지역) çè Level 19(좁은 지역)

3)Geocoding / ReverseGeocoding

4)POI(Point Of Interest)

5)GeoJSON / KML

6)Image Map / Vector Map

T map API 좌표계의 종류

< T map API 좌표계 타입 : coordType 파라미터 지정 >

§ EPSG3857 : Google Mercator

§ WGS84GEO : 경위도§ KATECH : TM128(Transverse Mercator:횡메카토르): 한국 표준§ BESSELGEO : GCS_Bessel_1841 타원체를 사용§ BESSELTM : Transverse_Mercator 투영법과

GCS_Bessel_1841 타원체를 사용§ GRS80GEO : GRS_1980 타원체를 사용§ GRS80TM : Transverse_Mercator 투영법과

GRS_1980 타원체를 사용§ BESSEL : 베셀 정규화 좌표계

the coordinate system (좌표계)

7

< T map API 좌표계 타입 : coordType 파라미터 지정 >

§ EPSG3857 : Google Mercator

§ WGS84GEO : 경위도§ KATECH : TM128(Transverse Mercator:횡메카토르): 한국 표준§ BESSELGEO : GCS_Bessel_1841 타원체를 사용§ BESSELTM : Transverse_Mercator 투영법과

GCS_Bessel_1841 타원체를 사용§ GRS80GEO : GRS_1980 타원체를 사용§ GRS80TM : Transverse_Mercator 투영법과

GRS_1980 타원체를 사용§ BESSEL : 베셀 정규화 좌표계

T map API

T map API의 default 좌표계는 EPSG3857로 되어 있음. 일반 위경도 좌표계를 사용할 경

우 좌표계 Type을 반드시 WGS84GEO로 지정한 후 사용해야 함

자주하는 실수들 - 좌표계

“서울 광장”의 위치를 각각의 좌표계로 나타내면 다음과 같습니다.

- EPSG3857 : Lat: "4518258.6620310" , Lon: "14135199.7637174"

- WGS84GEO : Lat: "37.5657321", Lon: "126.9786599"

- KATECH : Lat: "551988.4373341", Lon: "309969.0505621"

8

“서울 광장”의 위치를 각각의 좌표계로 나타내면 다음과 같습니다.

- EPSG3857 : Lat: "4518258.6620310" , Lon: "14135199.7637174"

- WGS84GEO : Lat: "37.5657321", Lon: "126.9786599"

- KATECH : Lat: "551988.4373341", Lon: "309969.0505621"

T map API

T map API의 default 좌표계는 EPSG3857로 되어 있음. 일반 위경도 좌표계를 사용할 경

우 좌표계 Type을 반드시 WGS84GEO로 지정한 후 사용해야 함

자주하는 실수들 - 좌표계

위도Latitude

9

위도Latitude

경도Longitude

기억방법 : Looooooooooong è 경도

T map API

T map API의 default 좌표계는 EPSG3857로 되어 있음. 일반 위경도 좌표계를 사용할 경

우 좌표계 Type을 반드시 WGS84GEO로 지정한 후 사용해야 함

자주하는 실수들 - 좌표계

ü 4.1.88. void setCenterPoint(double longitude,

double latitude, boolean animate)

ü 4.9.28. TMapAddressInfo

reverseGeocoding(double lat, double lon, String

addressType)

ü Tmap.LonLat(126.9786599, 37.5657321)

< 위경도 사용 예시 >

10

ü 4.1.88. void setCenterPoint(double longitude,

double latitude, boolean animate)

ü 4.9.28. TMapAddressInfo

reverseGeocoding(double lat, double lon, String

addressType)

ü Tmap.LonLat(126.9786599, 37.5657321)

T map API 웹지도 띄워보기

11

T map API JavaScript

12

T map API Geocoding

13

T map API API Console 이용하기(1)

https://developers.skplanetx.com/develop/self-console/

14

T map API API Console 이용하기(2)

API Console 의 가이드 문서를 잘 보자

15

T map API POI 검색하기

16

POI 정보에는 이름, 주소, 전화번호, 위경도좌표,

카테고리정보 등이 있음

T map API Geofencing

17

행정구역(시,도, 군, 구, 동)의 경계 표출 및 영역

내부/외부 판별 강남구 표출

T map API 경로안내

18

경로정보에는 전체경로의 길이, 주행시간,

유료도로요금, 각 구간별경로 주행 정보 등이

들어 있음

T map API 다중 경로안내

19

각 경유지별 거리, 시간, 경로정보 등을 출발시간, 일자 등을 수정해가면서

시뮬레이션 가능

STOP

도착시간 작업시간 출발시간 이동시간 운행거리

출발 09:00:00

1 09:22:39

10:00 09:32:39 22:39 9329

2 09:38:57

10:00 09:48:57 6:18 1272

차량번호 : 1

경유지 최적화(Route Optimization) API : T map RP를 이용하여 효율적으로 배송지들의 경로계획을 만들어,

운송시간, 배송지 도착시간, 운행거리 정보를 제공

T map API 경유지 최적화 API

20

09:38:57

3 09:49:48

10:00 09:59:48 0:51 376

4 10:02:59

10:00 10:12:59 3:11 593

5 10:19:04

10:00 10:29:04 6:05 1302

6 10:31:42

10:00 10:41:42 2:38 847

7 10:42:50

10:00 10:52:50 1:08 327

8 10:53:01

10:00 11:03:01 0:11 85

총 운행거리 : 23,060 m , 총 운행시간 : 약 1시간 10분

Ø 주요 특징l 배송지 100개 까지l 출발시간 기준 T map 교통정보l 배송지 도착 예약시간을 준수하는 배송계획

Ø 상품구성 및 일정l 배송지 개수(10개, 20개, 30개 이하) * 일사용 건수

T map API T map 연동

App에서 자동으로 T map App을 호출하며 목적지를 설정하여 경로안내 모드로 설정되도록 합니다.

API 구분 API 상세 특 징

T map Invoke 앱에서 목적지 위치 설정하여

T map 호출

< T map 실행시에 다양한 옵션 부여 가능 >- T map 길안내(특정위치지정, 목적지 지정), 특정 위치 보기, 통합검색 기능 수

행- 집으로/회사로, 안전운전도우미- T map 미설치된 경우에 설치 안내

※ 상세 파라미터 정보는 T map API SDK의 API 사용 설명서 4.10 항목 참조

21

T map 호출

T map API SDK 사용 어플

(목적지 정보)

T map에서바로 해당 목적지로길안내 가능

[T map 자동실행]

T map APISDK

개발자 센터 가입https://developers.skplanetx.com

11

22

API 이용 프로세스

개발자센터 API 이용 프로세스

22

22 API 문서 읽기 및 사용할 API 정하기

API Console에서 API 개발 연습하기https://developers.skplanetx.com/develop/self-console/

앱 등록 및 API키 발급 받기https://developers.skplanetx.com/apidoc/kor/t-map/javascript/

앱 개발하기

33

44

55

개발자센터 API 이용 프로세스

A service-level agreement (SLA) is defined as an official commitment that prevails between a service provider and a client . Particular aspects of the service – quality, availability, responsibilities – are agreed between the service provider and the service user. The most common component of SLA is that the services should be provided to the customer as agreed upon in the contract. As an example, Internet service providers and telcos will commonly include service level agreements within the terms of their contracts with customers to define the level(s) of service being sold in plain language terms. In this case the SLA will typically have a technical definition in mean time between failures (MTBF), mean time to repair or mean time to recovery (MTTR); identifying which party is responsible for reporting faults or paying fees; responsibility for various data rates; throughput; jitter; or similar measurable details.

What is SLA?

23

A service-level agreement (SLA) is defined as an official commitment that prevails between a service provider and a client . Particular aspects of the service – quality, availability, responsibilities – are agreed between the service provider and the service user. The most common component of SLA is that the services should be provided to the customer as agreed upon in the contract. As an example, Internet service providers and telcos will commonly include service level agreements within the terms of their contracts with customers to define the level(s) of service being sold in plain language terms. In this case the SLA will typically have a technical definition in mean time between failures (MTBF), mean time to repair or mean time to recovery (MTTR); identifying which party is responsible for reporting faults or paying fees; responsibility for various data rates; throughput; jitter; or similar measurable details.

개발자센터 API 이용 프로세스

SLA의 이해

SLA[에이엘에이]는 네트웍 서비스 공급업체와 고객간에 체결하는 계약으로서, 대개 어떤 서비스가 제공될 것인지를 측정이 가능한 조건으로 명시한 것이다. 많은 수의 인터넷 서비스 공급회사들이 SLA와 같은 형태의 계약을 고객들에게 제공한다.

다음은 SLA에 포함되어야할 척도들 중의 일부이다.

• 서비스될 수 있는 시간 비율 (%)

• 동시에 서비스할 수 있는 사용자의 수• 실제 성능을 주기적으로 비교할 수 있는 명확한 성능 기준• 사용자들이 영향을 받을 수 있는 네트웍의 변경작업 등을 사전에 고지하기 위

한 일정• 다양한 종류의 문제에 대한 고객상담실의 응답시간• 다이얼업 접속 가능성• 제공될 사용량 통계

24

SLA의 이해

SLA[에이엘에이]는 네트웍 서비스 공급업체와 고객간에 체결하는 계약으로서, 대개 어떤 서비스가 제공될 것인지를 측정이 가능한 조건으로 명시한 것이다. 많은 수의 인터넷 서비스 공급회사들이 SLA와 같은 형태의 계약을 고객들에게 제공한다.

다음은 SLA에 포함되어야할 척도들 중의 일부이다.

• 서비스될 수 있는 시간 비율 (%)

• 동시에 서비스할 수 있는 사용자의 수• 실제 성능을 주기적으로 비교할 수 있는 명확한 성능 기준• 사용자들이 영향을 받을 수 있는 네트웍의 변경작업 등을 사전에 고지하기 위

한 일정• 다양한 종류의 문제에 대한 고객상담실의 응답시간• 다이얼업 접속 가능성• 제공될 사용량 통계

개발자센터의 SLA 정보 확인 하기 : 테스트등급 => 상용등급은 직접 변경 가능함(사용량 상향 됨)

개발자센터 SLA 관리

25

T map API 활용 분야

위치 조회(안전)  다양한 위치기반 서비스(쿠키즈, 법무부 전자발찌)

Global  대한민국 지도 정보 제공

(Google 및 Microsoft)

전기차/자율주행  충전량을 고려한 경로제공  충전소 DB및 소요시간 정보제공  HD지도기반 자율주행 지원

Logistics  물류 차량 관제  Geo-fencing을 통한관할 지역 관리

(이마트, 롯데마트, 쿠팡, CU)

Shipping/Delivery  배송시간 정보 최적화  고객 현재 위치 근처음식점 검색(배달의 민족, 띵동)

26

전기차/자율주행  충전량을 고려한 경로제공  충전소 DB및 소요시간 정보제공  HD지도기반 자율주행 지원

대리운전/차량공유  최적의 차주 및 기사연결  T map을 활용한 안전운전 지원

(SoCar)

Games  위치기반 게임  Bike open rider(외계침공주식회사)

택시콜  고객의 목적지 정보 검색  고객 주변의 최적 배차

(아이원맥스)

Navigation  T map 원도를 기반으로하는 Car Navigation 서비스(시터스)

긴급출동  긴급 출동시 최단시간/거리 산정  T map 빠른길 정보 사용(GM/동부화재, 소방서 긴급출동)

Logistics  물류 차량 관제  Geo-fencing을 통한관할 지역 관리

(이마트, 롯데마트, 쿠팡, CU)

이마트 배송 시스템

l 전국 이마트 매장을 물류 거점으로 하여 온라인 매장 운영

l 온라인 몰 이용고객의 주문을 실시간으로 접수하고

고객이 원하는 시간대에 맞추어 배송

[ T map API 이용 사항 ]

l 실시간 경로 탐색 : 현시간 기준 교통정보 기반 경로 산출

l 타임머신 경로 탐색 : 패턴 교통정보를 이용한 경로 산출

- 서비스 내용 -

T map API 활용 분야 Logistics : 이마트, 롯데마트, CU

27

l 전국 이마트 매장을 물류 거점으로 하여 온라인 매장 운영

l 온라인 몰 이용고객의 주문을 실시간으로 접수하고

고객이 원하는 시간대에 맞추어 배송

[ T map API 이용 사항 ]

l 실시간 경로 탐색 : 현시간 기준 교통정보 기반 경로 산출

l 타임머신 경로 탐색 : 패턴 교통정보를 이용한 경로 산출

l 차량 고장/사고 위치 신고 시 긴급 출동 서비스 제공

l 고객과 가장 가까운 출동 기사 배정

l 고객에게 도착 예정 시간 통보

l 센터에서 고객 및 출동 기사 위치를 실시간 추적

[ T map API 이용 사항 ]

l 지도 API : 지도위에서 고객 및 출동기사 위치 표시

l 실시간 경로 : 고객까지 출동 기사 도착시간 산출

동부화재/GM차량긴급출동- 서비스 내용 -

T map API 활용 분야 긴급출동

28

l 차량 고장/사고 위치 신고 시 긴급 출동 서비스 제공

l 고객과 가장 가까운 출동 기사 배정

l 고객에게 도착 예정 시간 통보

l 센터에서 고객 및 출동 기사 위치를 실시간 추적

[ T map API 이용 사항 ]

l 지도 API : 지도위에서 고객 및 출동기사 위치 표시

l 실시간 경로 : 고객까지 출동 기사 도착시간 산출

SKT 쿠키즈 (Kids Phone)

l 아이 위치 실시간 추적

l 지정한 지역의 반경 이탈 시 즉시 부모에게 알림

l 아이 위치로 길안내 연결

[ T map API 이용 사항 ]

l 지도 API : 지도 위에서 아이 위치 표시

l Reverse Geocoding : 아이 위치 좌표 à 주소 변

l T map Invoke : T map 실행하여 즉시 길안내

- 서비스 내용 -

T map API 활용 분야 위치추적

29

l 아이 위치 실시간 추적

l 지정한 지역의 반경 이탈 시 즉시 부모에게 알림

l 아이 위치로 길안내 연결

[ T map API 이용 사항 ]

l 지도 API : 지도 위에서 아이 위치 표시

l Reverse Geocoding : 아이 위치 좌표 à 주소 변

l T map Invoke : T map 실행하여 즉시 길안내

E N D

30

E N D