---
order: 13
navTitle: 地点标注
---
# SuperPage组件-地点标注

SuperPage提供了GIS地图，使用地点标注组件可以在GIS上根据地址或经纬度标注出地理位置信息，并可以放大缩小查看。

![地点标注示例](./images/2021-03-12-20-33-38.png)

示例地址：[地点标注](https://demo.succbi.com/v5/DEMO/app/ap.app?id=%E5%9C%B0%E7%82%B9%E6%A0%87%E6%B3%A8)
:::tip
地点标注支持多种不同的底图风格显示，可以在[系统设置-外部服务-GIS](../../../../sys-settings/more/remote-services/gis.md)中自定义底图样式，并在**属性栏**>**样式**>**地图**>**底图风格**选择自定义的底图风格。
:::

## 使用地点标注组件{#start}

数据中包含了位置或经纬度信息，可以在GIS地图上标注出明确位置，且可以设置地图的显示级别，如在GIS上标出武汉建设银行硚口支行的位置，具体步骤如下：

![使用地点标注](./images/ddbz.gif)

- **绑定数据模型**：在**属性栏**>**地点标注**>**数据**中选择引用的数据模型，如`武汉建设银行硚口支行`模型
- **设置地址类型并绑定位置字段**：根据地址在数据模型中存储的数据类型选择[地址类型](#address-type)为**经纬度**或者**地址**，并设置相关位置字段
- **设置地图操作模式**：在**属性栏**>**地点标注**>**高级**下可设置地图的操作模式，如**点击放大显示**、**启用拖拽**、**启用缩放**等，更多设置见[地图操作模式](#operate)

:::tip
地点标注中只能标注一个地点，故引用的数据模型只能有一条数据，可通过对数据模型设置过滤条件或者设置为单行数据集，可参考文档[数据模型设置-过滤条件](../../../../data-viz/dash/design/datasource.md#filter)
:::

## 地址类型{#address-type}

地点标注可以根据地址或经纬度进行标注，地址类型可选**经纬度**或**地址**，默认为**经纬度**。选取地址类型后，需要设置对应的字段：

![地址类型](./images/2021-03-12-20-35-21.png)

- **经纬度**：当地址类型为经纬度时，需要选择**经度**和**纬度**字段，下拉选择数据模型中的**经度**、**纬度**字段即可，**经度**和**纬度**字段需要关联地理角色，参考文档[字段角色-地理](../../../../data-gov/model/field-role.md#geo)
- **地址**：当地址类型为地址时，需要选择**地址**字段，并可设置**地区**字段提高位置准确性
  - **地区**：可选，一般是行政区划之类的地理范围，可以是行政区划代码（如110000）或者行政区划名称（如湖北、武汉...）。当不指定地区时，默认为全国。选择明确的地区更有利于根据地址精确定位到地点
  - **地点代码**：可选，行政区划代码，用于对地址的标识，有利于根据地址精确定位到地点

## 地点标注信息设置{#label}

在GIS地图中可以添加提示信息，在**属性栏**>**地点标注**>**提示框**中设置：

![信息设置](./images/2021-03-12-20-36-03.png)

- **不显示**：始终不显示提示框，默认为**不显示**
- **点击后显示**：当在地图中点击该地点后显示提示信息，需要设置**提示信息**内容，输入自定义的内容即可
- **自动显示**：在地图中始终显示提示信息，需要设置**提示信息**内容，输入自定义的内容即可

可以为标注的点设置图标，在**属性栏**>**样式**>**图标**下，可以选择已有的图标或者上传自定义图标。

## 缺省地点标注设置{#center}

当数据返回的数据为空，或者在地图上找不到对应位置时，可以显示为缺省状态下的地点标注。可以**属性栏**>**地图**>**地图中心**中设置，有2种设置格式：

- 地址：直接输入具体地址，如`武汉市东西湖区革新大道388-1(1)`
- 经纬度：输入确定的经纬度，格式为`ARR(经度, 纬度)`，可参考[ARR()](../../../../exp/func/json/ARR.md)

![缺省设置](./images/2021-03-12-20-36-50.png)

## 地图显示级别设置{#map-level}

地图级别即设置地图可缩放的最大级别，缩放级别越大可显示的城市信息越详细。在**属性栏**>**地点标注**>**高级**中设置，显示级别包括：**自动**、**街道**、**县区**、**城市**、**省**、**国家**、**高级**。

- 默认为**自动**，即以当前地点为中心点，自动定格地图级别，为**自动**时不会将缩放级别锁死
- 当为**高级**时，需要输入**缩放级别**，可设范围为\[2，20]。数字越小，缩放级别越小，即地图的范围越大。可以使用[表达式](../../../../exp/README.md)动态获取地图显示级别，如获取输入框中输入的显示级别，表达式为`${[地图显示级别]}`

![地图显示级别](./images/2021-03-12-20-37-44.png)

## 地图操作模式{#operate}

在**属性栏**>**地点标注**>**高级**下可设置地图的操作模式，如点击地点后放大弹出对话框放大显示地点标注，双击对话框中的地点可以缩放地图，勾选**点击放大显示**即可。以及可以对地图**启用拖拽**、**启用缩放**等操作设置，可参考文档[地点分布](/superpage/component/gispoints/#operate)。

![地图操作模式](./images/2021-03-12-20-38-33.png)