> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# 定位
> 介绍了一款移动端定位组件的功能与使用场景，包括自动获取定位、允许微调、设置定位区域等特性。适用于员工考勤打卡、表单收集时验证真实位置以及地址POI信息管理等场景。
## 1. 定位组件基础介绍
### 1.1 什么是定位组件
一款可以在移动端获取地理位置信息的组件
### 1.2 使用场景
* 基于指定区域的员工考勤打卡上报系统
* 表单收集填报时，提交当前填报人的所在真实位置（实人实地，防作弊）
* 基于地理位置的地址 POI 信息管理系统
* 目前 仅支持移动端定位 （电脑端会引导提示）
## 2. 功能介绍
### 2.1 自动获取定位
* 如果开启了手机定位权限，在进入提交页面后，定位组件会自动获取当前所在位置，并将信息显示在定位组件展示框中，开启自动定位的操作如下：
开启自动获取定位功能
效果展示如下：
### 2.2 允许微调
* 支持手机端在获取定位的过程中，基于当前所在位置作为中心点，在指定半径的圆形范围内，选取其他的 POI 地点信息
* 微调的半径范围支持设置为 100 米\~5000 米
开启允许微调功能
### 2.3 设置定位区域
* 可以设置定位中心规则，将可选位置限制在指定区域内，比如设置的定位地址是杭州东站，设置的定位范围是 500 米，那么在杭州东站 500 米范围内才可定位。
开启设置定位区域功能
新增定位中心
### 2.4 当定位组件的状态设置只读时移动端不可以定位
需要自动获取定位，需要将定位组件的状态修改为普通，目前只有普通状态下才可以自动获取定位
仅移动端【普通】状态下有效
### 2.5 定位组件的数据格式
```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"regionIds": [330000, 330100, 330110, 330110005],
"regionText": [
{ "en_US": "zhe jiang sheng", "pureEn_US": "zhe jiang sheng", "type": "i18n", "zh_CN": "浙江省" },
{ "en_US": "hang zhou shi", "pureEn_US": "hang zhou shi", "type": "i18n", "zh_CN": "杭州市" },
{ "en_US": "yu hang qu", "pureEn_US": "yu hang qu", "type": "i18n", "zh_CN": "余杭区" },
{ "en_US": "wu chang jie dao", "pureEn_US": "wu chang jie dao", "type": "i18n", "zh_CN": "五常街道" }
],
"region": "浙江省杭州市余杭区五常街道",
"address": "良睦路靠近乐佳国际",
"longitude": 120.009174,
"latitude": 30.27976
}
```
## 3. 效果展示
温馨小提示：视频属于手机录屏，无语音讲解
## 4. 常见问题
### 4.1 为什么定位组件部分地区搜索不到？
开启定位组件允许微调后，若需要搜索非当前城市的地址需在地址前面加上省、市或县，否则会出现搜索不到的情况，如：北京合生汇，单独搜索合生汇展示暂无数据。
