Skip to main content

위치 요청 결과 레퍼런스

이 문서는 SDK 이벤트 수신 시 확인하는 PlengiResponse 필드 설명 문서입니다.

결과 수신 위치​

위치 인식 결과는 PlengiListener.listen(PlengiResponse response) 에서 받습니다.

tip

리스너 생성 및 등록은 SDK 초기화 문서를 참고해 주세요.

public class LoplatPlengiListener implements PlengiListener {
    @Override
    public void listen(PlengiResponse response) {
        if (response.result == PlengiResponse.Result.SUCCESS) {
            // 성공 처리
        } else {
            // 실패/에러 처리
        }
    }
}

PlengiResponse 공통 필드​

warning

가이드하지 않은 필드들은 테스트용이거나 deprecated 예정이니 사용하지 않는 것을 권장합니다.

필드설명상세
echo_code사용자 식별 코드setEchoCode()로 등록한 값을 echo
result위치 인식 결과SUCCESS: 위치 인식 성공, FAIL: 위치 인식 실패
errorReason실패 사유Location Acquisition Fail : 현재 위치 획득 실패
Not Allowed Client: 클라이언트 인증 실패 (client_id, client_secret, 패키지명 확인 필요)
type요청 타입ResponseType.PLACE: 테스트용 요청
ResponseType.PLACE_EVENT: SDK 내부 로직에 따른 요청
placeEvent인식된 event 타입NOT_AVAILABLE: place 확인 불가(area, complex, geofence 등 다른 정보는 있을 수 있음)
ENTER: place 진입
NEARBY: place 근처

위치 인식 성공 시 주요 객체​

warning

가이드하지 않은 필드들은 테스트용이거나 deprecated 예정이니 사용하지 않는 것을 권장합니다.

warning

위치 정보를 종합해서 판단한 결과가 PlengiResponse로 전달됩니다.

판단 결과에 따라 매장 정보가 없이 상권 정보, 복합몰 정보만 있을 수 있고, 행정구역 정보만 있는 경우도 있습니다.
(일부 필드가 null인 경우 또한 정상 동작)

모든 필드는 nullable이므로 활용하려는 값은 null 여부를 확인한 뒤 사용해 주세요.


위치 요청 실패 여부는 공통 필드의 result와 errorReason를 확인해 주세요.

필드설명
response.place장소 정보 (매장)
response.area상권 정보
response.complex복합몰 정보
response.geoFence지오펜스 정보
response.district행정구역 정보
response.location기기 위·경도 정보

Place 필드​

실제 SDK 타입은 Java 클래스입니다. 아래는 필드 의미를 맞춰 본 예시입니다.

class Place {
    public long loplatid;       // 장소 ID
    public String name;         // 장소 이름
    public String tags;         // 장소 관련 태그
    public int floor;           // 층 정보
    public String category;     // 장소 유형
    public String category_code;// 장소 유형 코드
    public double lat;          // 인식된 장소 위도
    public double lng;          // 인식된 장소 경도
    public float accuracy;      // 정확도
    public float threshold;     // 인식 임계값
    public String address;      // (구)주소
    public String address_road; // 도로명 주소
    public String post_code;    // 우편번호
}
  • accuracy > threshold: 현재 위치 내부로 판단
  • 그 외: 주변(NEARBY)으로 판단 가능

Area 필드​

장소 위치 요청한 장소가 상권 안일 경우 상권 정보가 인식 결과에 함께 전달됩니다.

위도 및 경도는 아래의 조건으로 결과가 전달됩니다.

  • 장소 인식 결괏값이 있다면 -> 인식된 장소 위도/경도
  • 장소 인식 결괏값이 없으면 -> device의 위도/경도
class Area {
    public int id;         // Area ID
    public String name;    // 상권 이름
    public String tag;     // 상권 태그(도/시 등)
    public double lat;     // 위도
    public double lng;     // 경도
}

Complex 필드​

인식된 장소가 복합몰 내인 경우, 복합몰 정보도 함께 인식 결과에 포함되어 전달됩니다.

class Complex {
    public int id;             // Complex ID
    public String name;        // 복합몰 이름
    public String branch_name; // 복합몰 지점명
    public String category;    // 카테고리
    public String category_code;// 카테고리 코드
}

GeoFence/Fence 필드​

매칭된 지오펜스 구역의 정보가 전달됩니다.

class Geofence {
    private double lat;               // GeoFence 중심 위도
    private double lng;               // GeoFence 중심 경도
    private ArrayList<Fence> fences;  // Fence 목록
}

class Fence {
    private long gfid;        // 지오펜스 관리 ID
    private float dist;       // 중심 좌표 기준 거리(optional)
    private String name;      // 이름
    private String clientCode;// 고객사 관리 ID
}

District 필드​

인식된 행정구역 정보입니다.

class District {
    private String lv0_code; // 국가 코드
    private String lv1_code; // 시/도 코드
    private String lv1_name; // 시/도 이름
    private String lv2_code; // 구/군 코드
    private String lv2_name; // 구/군 이름
    private String lv3_code; // 동/면 코드
    private String lv3_name; // 동/면 이름
}