CATCH LOC Developers

최근위치정보 조회 API

Description

위치오브젝트의 최종 수집된 위치를 조회하는 API.

API

http://cms.catchloc.com/api.get.member.location.last.php

Parameters

api_key : 파트너 API_KEY
member_key : 적용대상의 MEMBER_KEY
timestamp : 현재시간 Unix timestamp
cert_key : API 인증용 hash key

Response

protocol : JSON Object
member_key : 조회대상 MEMBER_KEY
name : 조회대상 이름
latitude : 위도
longitude : 경도
accuracy : 위치 정확도(m)
speed : 속도(km)
odometer : 총 누적이동거리(m)
location_date : 위치확인시간(Unix timestamp, milliseconds)

Example


            ===== Request =====

            http://cms.catchloc.com/api.get.member.location.last.php?
            api_key= abcdefghijklmnopqrstuvwxyz1234567890&
            member_key=abcdefghijklmnopqrstuvwxyz1234567890&
            timestamp=1446624149000&
            cert_key=abcdefghijklmnopqrstuvwxyz1234567890



            ===== Response =====

            - 성공 시            
            {
                "member_key":"developer@catchloc.com",
                "name":"developer@catchloc.com",
                "latitude":"37.3984002",
                "longitude":"126.9632804",
                "accuracy":44.343,
                "speed":64.5,
                "odometer":735976,
                "location_date":1459927833000
            }

            - 실패 시
            {
                "result":"FAIL",
                "message":"에러 사유"
            }


            ===== Request =====

            String member_key = "위치수집대상에 부여된 키";

            CatchLoc catchloc = new CatchLoc();

            catchloc.setApiKey("API키");
            catchloc.setServerKey("서버키");

            JSONObject result = catchloc.getLastData(member_key);



            ===== Response (JSONObject) =====

            {
                "result"  : "ok",
                "type"    : "jsonobject"
                "message" : API Response Body (JSONObject)
            }


            ===== Request =====

            import CatchLocSDKForAPI (공통)

            CatchLocAPI.shared.setApiKey(API_KEY)
            CatchLocAPI.shared.setserverKey(SERVER_KEY)

            -MEMBER_KEY : 적용대상의 MEMBER_KEY

            CatchLocAPI.shared.getLastData(memberkey: MEMBER_KEY)
            { result in
                let jsonData = result.response

                혹은 

                let jsonStr = result.description()
            }


            ===== Response =====

            {
                "response" : API Response Body
            }


            ===== Request =====
            
            $member_key = '위치수집대상에 부여된 키';

            $catchloc = new CatchLoc();

            $catchloc->setApiKey("API키");
            $catchloc->setServerKey("서버키");

            $result = $catchloc->getLastData($member_key);


            ===== Response (JSON 형태의 문자열) =====

            "{
                "result"  : "ok",
                "type"    : "map"
                "message" : API Response Body
            }"


            ===== Request =====

            var callback = function(json)
            {
                api 응답값을 처리하는 콜백함수의 내용
                (예시 : 지도에 위치 출력 혹은 목록 출력)
            };

            var params =
            {
                member_key: '위치수집대상에 부여된 키',
            };

            CatchLoc.setApiKey("API키");
            CatchLoc.setServerKey("서버키");

            CatchLoc.getLastData(params, callback);



            ===== Response (JSON, callback 함수의 매개변수 내용) =====

            {
                "result"  : "ok",
                "type"    : "json"
                "message" : API Response Body (json)
            }