사용자의 위치를 기반으로 서비스를 제공할 수 있는 API

높은 정확도를 기반으로 사용자에게 위치 기반 맞춤형 서비스를 제공할 수 있으며,
하나의 API에서 복합적인 정보 조회가 가능하여 개발 및 관리를 위한 리소스를 줄일 수 있습니다.

  • 높은 정확도

    전국에 펼쳐져있는 KT의 망을 이용하여, 사용자 위치 판별의 정확도가 향상되어있으며 이를 기반한 서비스 제공이 가능합니다.

  • 안정적인 서비스 제공

    다년간 쌓아온 운영 노하우 및 KT의 통합 시스템을 이용하여 안정된 서비스 개발 및 운영이 가능한 환경을 제공 하며 이를 바탕으로 더 많은 수익 창출이 가능하도록 지원합니다.

  • 맞춤형 서비스

    본인의 최근 위치와 현재 위치, 좌표, 주소, 지도 등의 정보를 활용하여, 사용자에게 위치기반 맞춤형 서비스 제공이 가능합니다.

  • 손쉬운 개발

    일반적으로 사용되는 SOAP연동 방식을 지원하며 보다 빠른 개발을 위하여 SDK제공 및 서비스별 맞춤형 개발지원을 실시 합니다.

상세 기능

위치 서비스 API에서 제공하는 정보를 위한 분류 기준에 대하여 설명 합니다.

다양한 인터페이스

본인의 좌표, 주소, 지도 정보를 이용할 수 있으며, KT 망 뿐만 아니라 타사 가입자의 위치 조회도 가능하며, 원하는 데이터를 활용하여 지도를 쉽게 표현 할 수 있는 인터페이스를 제공합니다. 타인의 위치를 조회할 경우 상호 인증이 필요하며, 이에 대한 인증 인터페이스 또한 제공됩니다.

부드럽고 빠른 반응 속도

SOAP 연동 방식을 제공하며, 다양한 플랫폼에 대응이 가능합니다. 특히 데스크탑 뿐만 아니라 모바일 환경에서도 부드럽고 빠른 반응 속도를 제공하며, 이를 이용하여 사용자 위치 기반의 서비스 구축이 가능합니다.

테마, 분실폰 찾기 제공

사용자의 좌표, 위치를 이용하여 맛집, 영화관 등의 테마 제공이 가능하며, 해당 위치에 맞는 정보 큐레이트가 가능합니다. 또한 좌표, 위치, 주소 정보를 이용하여, 인증 없이 분실폰 찾기가 가능합니다. 일부 서비스 API는 KT 사용자만 이용이 가능합니다.

이용안내

위치 서비스 API를 사용하기 위한 프로세스 입니다.

프로젝트 생성 및 API신청
  • 서비스 소개, API별 상세 사용 내역 등 기본 정보를 포함하여 프로젝트 생성
  • 서비스 개발에 필요한 플랫폼 별 API신청
개발 및 검증
  • API신청 후 발급받은 TEST KEY를 이용하여 개발 진행
  • 프로젝트 생성시 입력한 정보와 개발 내용을 검토하여 검증 진행
인증키 발급
  • 상용 서버 IP정보 입력 후 인증키 발급 요청
  • 플랫폼 (or 서비스 담당)권한으로 인증키 발급
서비스 상용
  • 프로그램에 등록되어 있는 개발키를 발급된 상용 인증키로 교체 후 상용 배포
  • apilink.kt.co.kr에서 제공하는 모니터링 도구를 이용하여 모니터링 진행

API 목록

위치서비스 API는 기본적으로 무과금 API에 대해서만 사용이 허용되며 과금 API이용을 원하실 경우 사전에 협의를 진행해야 합니다.

: 관리자 승인 없이 사용 가능 : 관리자 승인 후 사용 가능

API명 구분 내용
GetStaticMap
대내용
1 좌표정보를 이용하여 지도 정보를 조회하는 기능을 제공한다.
LocationCRSCheck
대내용
1. 요청자가 대상자의 위치 조회를 가능하도록 권한을 부여하는 API이다. 2. 본 API는 양방향이 아닌 일방향 위치 조회 권한을 부여하는 것이기 때문에 두 사용자가 서로의 위치 조회를 하기 위해서는 A->B, B->A 총 2번을 호출해야 한다. (1) A->B: A가 B의 위치 조회가능 (2) B->A: B가 A의 위치 조회가능
LocationFindPosition
대내용
1. 대상자의 현재위치 및 최근위치를 조회 가능하다. 2. 본인의 좌표, 주소, 지도 정보를 가져올 수 있다. 3. 타인의 위치를 조회할 경우 상호인증이 되어야 조회가 가능하다. 4. QOS=0(CELL_HDR)일 경우 본인의 Cell Header 정보를 통해 현재 위치를 조회한다.
LocationFindPosition2
대내용
1. 대상자의 현재위치 및 최근위치를 조회 가능하다. 대상자의 가입 상태가 ‘일시정지’라도 조회 가능하다. 2. 본인의 좌표, 주소, 지도 정보를 가져올 수 있다.. 3. 타인의 위치를 조회할 경우 상호인증이 되어야 조회가 가능하다 4. QOS=0(CELL_HDR)일 경우 본인의 Cell Header 정보를 통해 현재 위치를 조회한다.
LocationFindPosition3
대내용
1. 대상자의 현재위치 및 최근위치를 조회 가능하다. 대상자의 가입 상태가 ‘일시정지’라도 조회 가능하다. 2. 본인의 좌표, 주소, 지도 정보를 가져올 수 있다.. 3. 타인의 위치를 조회할 경우 상호인증이 되어야 조회가 가능하다 4. QOS=0(CELL_HDR)일 경우 본인의 Cell Header 정보를 통해 현재 위치를 조회한다.
LocationFindPositionHybrid
대내용
1. OIF_2003 LocationFindPosition과 기본적으로 동일한 기능을 제공하나 기지국, GPS, WiFi 방식 등 여러 측위 방식으로 동시에 위치 조회하는 경우 사용한다. 2. 여러 측위 방식으로 요청하는 경우 각 측위 방식의 결과는 OIF_2811 LocationReportAsyncHybrid API 사용하여 전달 받는다.
LocationFindPositionReport
대내용
1. 위치 조회 결과를 비동기 방식으로 전달 받아야 하는 경우 사용하는 API이다. 2. CP에서 위치 조회 요청 시 결과를 전달 받기 위해 피드백 HTTP URL을 포함하여야 한다. 3. 기타 사용 방법은 OIF_2003 LocationFindPosition와 동일하다.
LocationJoinInfoLostCp
대내용
1. 분실폰 서비스 가입자 현행화 정보를 관리하는 인터페이스이다. (가입삭제조회) 2. 분실폰 서비스에서만 이용이 되며, 고객센터에서 사전 인증된 사항이라 내부인증 진행하지 않는다.
LocationJoinInfoMNGCp
대내용
1. 서비스 별 가입자 정보를 관리를 한다. 2. 긴급 서비스를 제외하고 필수로 본 API를 사용하여 가입자 정보를 등록하여야 위치 조회가 가능하다. 3. 해당 서비스에 해지/탈퇴를 하는 경우 가입자 정보는 본 API를 사용하여 반드시 삭제 처리를 해야 한다. 4. SVC_TYPE 필드에 입력된 값에 따라 등록/삭제/조회 처리를 하게 된다. (1) 서비스 가입 시 - 가입자 등록 요청(SVC_TYPE=1) (2) 서비스 시나리오에 따라 조회 필요 시 - 가입자 조회 요청(SVC_TYPE=3) (3) 서비스 해지/탈퇴 시 - 가입자 삭제 요청(SVC_TYPE=2)"
LocationListCRS
대내용
1. OIF_2005 LocationCRSCheck를 사용하여 등록 된 상호 인증 정보를 조회하는 API이다.