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