# Location Kit简介

#### Location Kit开发概述

移动终端设备已经深入人们日常生活的方方面面，如查看所在城市的天气、新闻轶事、出行打车、旅行导航、运动记录。这些习以为常的活动，都离不开定位用户终端设备的位置。

当用户处于这些丰富的使用场景中时，系统的位置能力可以提供实时准确的位置数据。对于开发者，设计基于位置体验的服务，也可以使应用的使用体验更贴近每个用户。

当应用在实现基于设备位置的功能时，如：驾车导航，记录运动轨迹等，可以调用该模块的API接口，完成位置信息的获取。

#### Location Kit简介

位置子系统使用多种定位技术提供服务，如GNSS定位、基站定位、WLAN/蓝牙定位（基站定位、WLAN/蓝牙定位后续统称“网络定位技术”）；通过这些定位技术，无论用户设备在室内或是户外，都可以准确地确定设备位置。

*   **坐标**
    
    系统以1984年世界大地坐标系统为参考，使用经度、纬度数据描述地球上的一个位置。
    
*   **GNSS定位**
    
    基于全球导航卫星系统，包含：GPS、GLONASS、北斗、Galileo等，通过导航卫星、设备芯片提供的定位算法，来确定设备准确位置。定位过程具体使用哪些定位系统，取决于用户设备的硬件能力。
    
*   **基站定位**
    
    根据设备当前驻网基站和相邻基站的位置，估算设备当前位置。此定位方式的定位结果精度相对较低，并且需要设备可以访问蜂窝网络。
    
*   **WLAN、蓝牙定位**
    
    根据设备可搜索到的周围WLAN、蓝牙设备位置，估算设备当前位置。此定位方式的定位结果精度依赖设备周围可见的固定WLAN、蓝牙设备的分布，密度较高时，精度也相较于基站定位方式更高，同时也需要设备可以访问网络。
    

Location Kit除了提供基础的定位服务之外，还提供了地理围栏、地理编码等功能。

*   地理围栏（英语：GeoFence）是虚拟地理边界，当设备进入、离开某个特定地理区域时，可以接收自动通知和警告。
    
*   地理编码（英语：GeoCode）是表示地理实体（位置或要素）的代码。
    
    *   正地理编码：根据地址获取地点的经纬度。
        
    *   逆地理编码：获取经纬度对应的地点信息。
        

#### 约束与限制

位置能力作为系统为应用提供的一种基础服务，需要应用在所使用的业务场景，向系统主动发起请求，并在业务场景结束时，主动结束此请求，在此过程中系统会将实时的定位结果上报给应用。

使用设备的位置能力，需要用户进行确认并主动开启位置开关。如果位置开关没有开启，系统不会向任何应用提供定位服务。

设备位置信息属于用户敏感数据，所以即使用户已经开启位置开关，应用在获取设备位置前仍需向用户申请位置访问权限。在用户确认允许后，系统才会向应用提供定位服务。

Location Kit在不同的设备上提供不同的能力，并且部分能力依赖于硬件的支持。例如GPS、北斗等定位芯片，可以为设备提供GNSS定位能力；在没有定位芯片但具有WLAN或者蜂窝网络的设备，可以获取WLAN定位、基站定位能力。

#### 支持的国家/地区

支持的设备中Wearable设备支持以下支持的国家/地区，其他设备仅支持中国境内（不包含中国香港、中国澳门、中国台湾）。

#### 支持的设备

本kit仅适用于Phone、Tablet、PC/2in1和Wearable。

#### 模拟器支持情况

本Kit支持模拟器。

模拟器与真机存在通用差异，详情请参见模拟器与真机的差异。