CATCH LOC Developers

구간지정 위치데이타 조회 API

Description

위치오브젝트의 특정시간을 지정하여 해당 구간의 위치를 조회하는 API.

API

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

Parameters

api_key : 파트너 API_KEY
member_key : 적용대상의 MEMBER_KEY
timestamp : 현재시간 Unix timestamp
cert_key : API 인증용 hash key
from_date : 위치조회 시작시간(Unix timestamp)
to_date : 위치조회 종료시간(Unix timestamp)

Response

protocol : JSON Array
number : 위치번호
latitude : 위도
longitude : 경도
accuracy : 위치 정확도(m)
in_date : 위치 Check in time(Unix timestamp)
out_date : 위치 Check out time(Unix timestamp)
reg_date : 위치등록시간(Unix timestamp)
poi_info : 위치정보
distance : 이동거리
speed : 이동속도

Example


            ===== Request =====

            http://cms.catchloc.com/api.get.member.location.list.php?
            api_key= abcdefghijklmnopqrstuvwxyz1234567890&
            member_key=abcdefghijklmnopqrstuvwxyz1234567890&
            timestamp=1446624149000&
            cert_key=abcdefghijklmnopqrstuvwxyz1234567890&
            from_date=1459843188&
            to_date=1459929588



            ===== Response =====

            - 성공 시            
            [
                {
                    "number":1,"latitude":"37.3983257","longitude":"126.9637085","accuracy":14.137,
                    "in_date":1459929149,"out_date":1459929149,"reg_date":1459929149,
                    "poi_info":"\ub124\ud2b8\uc6cc\ud06c","distance":34.6406400004,"speed":0
                },
                {
                    "number":2,"latitude":"37.3980153","longitude":"126.9634767","accuracy":47.597,
                    "in_date":1459928548,"out_date":1459929149,"reg_date":1459928548,
                    "poi_info":"\ub124\ud2b8\uc6cc\ud06c","distance":42.95484,"speed":0.257300206323
                },
                {
                    "number":3,"latitude":"37.3984002","longitude":"126.9632804","accuracy":44.343,
                    "in_date":1459927833,"out_date":1459928548,"reg_date":1459927833,
                    "poi_info":"\ub124\ud2b8\uc6cc\ud06c",
                    "distance":4.07340000002,"speed":0.0205094265735
                },......
            ]

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


            ===== Request =====

            String member_key = "위치수집대상에 부여된 키";
            String from_date = "구간시작시간 유닉스 타임스탬프(10자리)";
            String to_date = "구간종료시간 유닉스 타임스탬프(10자리)";

            CatchLoc catchloc = new CatchLoc();

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

            JSONObject result = catchloc.getDataBetween24Hours(member_key);



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

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


            ===== Request =====

            import CatchLocSDKForAPI (공통)

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

            -MEMBER_KEY : 적용대상의 MEMBER_KEY
            -START_UNIX_TIME : 위치조회 시작시간(Unix timestamp)
            -END_UNIX_TIME : 위치조회 종료시간(Unix timestamp)

            CatchLocAPI.shared.getDataBetween24Hours(memberKey: MEMBER_KEY, startUnixTime: START_UNIX_TIME, endUnixTime: END_UNIX_TIME)
            { result in
                
                let jsonData = result.response

                혹은

                let jsonString = result.description()                
            }


            ===== Response =====

            {
                "response" : API Response Body
            }


            ===== Request =====
            
            $member_key = '위치수집대상에 부여된 키';
            $from_date = '구간시작시간 유닉스 타임스탬프(10자리)';
            $to_date = '구간종료시간 유닉스 타임스탬프(10자리)';

            $result = $catchloc->getDataBetween24Hours($member_key, $from_date, $to_date);


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

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


            ===== Request =====

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

            var params =
            {
                member_key: '위치수집대상에 부여된 키',
                from_date: '구간시작시간 유닉스 타임스탬프(10자리)',
                to_date: '구간종료시간 유닉스 타임스탬프(10자리)',
            };

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

            CatchLoc.getDataBetween24Hours(params, callback);



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

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