定位行为
Zion 平台支持多种定位相关行为，适用于微信小程序端，包括获取当前位置、选择位置、打开地图及行政区域名称解析等常见场景。
定位行为包括：
- 获取位置
- 选择位置
- 打开位置
- 获取行政区域名称
获取位置
获取位置行为可获取当前所在位置的经纬度，并赋值给页面数据。常与地图组件结合，将位置显示在地图上，广泛应用于地图、打车、外卖等场景，满足用户定位需求。
行为配置
添加页面数据
需在页面添加类型为“经纬度”的页面数据（如 geographic_position），用于暂存获取到的经纬度。若页面有多个相关数据，建议重命名以便区分。
添加行为
为组件添加“定位-获取位置”行为，将获取到的经纬度赋值给页面数据。获取成功后返回经纬度对象，需结合获取行政区域名称行为解析，或直接用于地图组件定位。
| 行为选择界面 | 赋值页面数据界面 |
|---|---|
 |  |
位置数据的使用
获取位置后，可在页面添加地图组件并绑定经纬度，实现实时定位。
- 未获取位置前，地图默认定位天安门；获取成功后自动定位到当前位置。
- 地图组件支持手动缩放、移动。
| 定位前效果 | 定位后效果 |
|---|---|
 |  |
解析获取的位置
如需将经纬度解析为具体地址，可结合获取行政区域名称行为实现。
特殊说明
- 首次点击获取位置按钮会弹出用户授权窗口，需用户同意后方可获取当前位置。
- 用户拒绝授权后再次点击，会引导用户开启授权。
选择位置
选择位置行为支持在地图上选择地理位置，自动唤起腾讯地图，选择后可获取经纬度、地址及名称。
行为配置
添加页面数据
需在页面添加类型为“经纬度”的页面数据（保存经纬度），及两个“文本”类型页面数据（保存地址和名称）。
| 新建页面数据 | 命名和选择类型 |
|---|---|
 |  |
添加行为
为组件添加“定位-选择位置”行为，将获取到的经纬度、地址、名称赋值给页面数据。
| 配置行为界面 | 配置行为界面 |
|---|---|
 |  |
位置数据的使用
获取到的经纬度、地址、名称可用于地图组件展示，地址字段包含省市区及街道，名称为具体位置名称。
| 效果展示1 | 效果展示2 | 效果展示3 |
|---|---|---|
 |  |  |
展示选择的位置
在按钮上配置选择位置行为，并将地址赋值给页面数据 location，在文字组件绑定该数据。选择位置时，腾讯地图默认显示当前定位，选择后文字组件显示所选地址。
| 效果展示 | 效果展示 |
|---|---|
 |  |
特殊说明
- 仅支持小程序端配置。
打开位置
点击后自动弹出腾讯地图，显示绑定经纬度对应的位置，可用于导航等功能。
案例
导航到选择的位置：在选择位置的成功行为中配置“打开位置”行为，绑定页面数据，点击按钮即可弹出腾讯地图并导航。
| 行为配置界面 | 效果展示 |
|---|---|
 |  |
行为配置
为组件添加“定位-打开位置”行为，绑定远程数据或【获取/选择位置】获得的经纬度，地址和名称可选填。
| 行为选择界面 | 配置经纬度界面 |
|---|---|
 |  |
特殊说明
- 仅支持小程序端配置。
- 地址和名称影响地图名称显示，未填写则不显示（不会报错）。用其他导航软件打开时，显示为微信位置起点和终点。
获取行政区域名称
将经纬度解析为详细位置信息，包括 country（国家）、province（省份）、city（城市）、district（区/县）、township（街道/乡镇）。一般在选择或获取位置后实现。
行为配置
添加页面数据
需在页面添加类型为“位置信息”的页面数据（如 location_info）用于暂存行政区域名称。
添加行为
一般在选择/获取位置的成功时配置“获取行政区域名称”行为，将经纬度绑定到该行为，并将结果赋值给页面数据。
| 选择行为 | 赋值页面数据 | 成功时配置 |
|---|---|---|
 |  |  |
行政区域名称的数据使用
- 显示/使用行政区域名称：可在页面文字组件绑定 location_info 中的字段（如 country、province、city、district、township），或绑定到输入框作为配送地址。
| 行为配置示意图 | 行为配置示意图 |
|---|---|
 |  |
- 显示效果
| 效果展示 | 效果展示 |
|---|---|
 |  |
特殊说明
- 仅支持小程序端配置。