地图可视化

地图可视化在地理图上显示结果。查询结果集必须包括相应的地理数据：

分级着色：地理区域（例如国家或州）根据每个关键列的汇总值进行着色。查询必须按名称或 GEOMETRY 或 GEOGRAPHY 列返回地理位置。有关示例，请参阅 choropleth 示例。
点图：标记放置在地图上的一组坐标处。查询结果必须返回纬度和经度对或 GEOMETRY 或 GEOGRAPHY 列。有关示例，请参阅标记示例。

还可以从 GEOMETRY 或 GEOGRAPHY 列呈现形状，而不是依赖于预定义的管理边界或单独的纬度和经度列。请参阅自定义地理数据。

Choropleth 选项

根据数据中的数值，对地理区域（如国家/地区、州或县）进行绘制颜色。

示例

在 “数据 ”选项卡中，单击“ + 添加 SQL 数据集”，粘贴以下查询，然后运行它：

示例数据集

'''sql SELECT state， total_sales FROM VALUES （'加州'， 98750），（'得克萨斯州'， 87200），（'纽约'， 76300）、（佛罗里达州、65100）、（伊利诺伊州、54800）、（宾夕法尼亚州、48200）、（俄亥俄州、43500）、（“佐治亚州”、“41200”、“北卡罗来纳州”、“39700”、“密歇根州”、“36100”、“新泽西州”、“新泽西州” 34800）、（“弗吉尼亚州”、“32500”、“华盛顿”、“31200”、“亚利桑那”、“29700”、“马萨诸塞州”、“28400”、“田纳西州”、“26900年” ）（'印第安纳州'， 25100），（'密苏里州'， 23800），（'马里兰州'， 22600），（'威斯康星州'， 21300），（'明尼苏达州'， 20100），（'科罗拉多'， 19400），（'阿拉巴马州'， 18200），（'南卡罗来纳州'， 17600），（路易斯安那州， 16900），（'肯塔基'， 15800），（'俄勒冈'， 14700）、（俄克拉荷马州、13600）、（康涅狄格州、12500）、（犹他州、11900）、（爱荷华州、11200）、（内华达州、10800）、（“阿肯色州”、“10100”）、（“密西西比州”、 9600）、（“堪萨斯州”、“9200”、“新墨西哥州”、“8700”、“内布拉斯加州”、“8300”、“西弗吉尼亚州”、“7900”、“爱达荷州”、“7400”、“夏威夷” ， 7100，（'新罕布什尔州'， 6800），（缅因州， 6400），（蒙大拿州， 6100），（'罗得岛'， 5800），（'特拉华州'， 5400），（南达科他州，5100年），（北达科他州，4800），（阿拉斯加州，4500），（佛蒙特州，4200），（'怀俄明'，3900）AS（州，total_sales）：```

在可视化编辑器中，配置以下内容：

将可视化类型设置为 Choropleth 映射。
在 “区域” 部分的 “国家/地区”下，单击加号图标。在 Values 下，单击选择国家/地区并选择美国。
在 “区域” 部分中，在 “州/省 ”下，单击加号图标。在 “字段”下，选择 state。
在 “颜色”下，单击加号图标，选择 total_sales，并将转换设置为 SUM。

区域

“区域”设置告知地图如何解释数据中的位置值。选择与数据匹配的格式：

行政：国家、 州/省、 县/市、 镇/乡或 市/村
邮政：邮政编码。
CSA/CSAB：美国人口普查局统计区域指定。 CSA （综合统计区）将邻近的大都市和微政治地区与经济联系在一起。 CBSA （基于核心的统计区域）涵盖各个大都市和微政治区域。
立法：美国立法区，包括国会选区和州参议院区。
NUT：用于统计的领土单位的欧盟名词。支持三个级别： 坚果 1 （主要社会经济区域）、 坚果 2 （应用区域政策的基本区域）和 坚果 3 （特定诊断的小区域）。
自定义几何图形：选择 GEOMETRY 或 GEOGRAPHY 列以直接从数据呈现区域边界。请参阅自定义地理数据。

如果位置列中的值与所选格式不匹配，则该区域不会显示任何数据。下载以下查找表以检查支持哪些名称和缩写：

注释

使用 name_en 列查找值，但使用其他列之一作为查询中的标识符。

颜色

颜色会自动填充具有数据的每个区域。单击颜色样本以选择不同的颜色。

可视化编辑器中的颜色设置部分显示所选颜色和带更多选项的加号。

若要按数字字段颜色区域，请单击 “加号”图标。 “ 颜色 ”部分中的加号图标并选择一个字段。可以应用转换，例如 SUM 或 MEDIAN。地图在值范围内应用颜色渐变。若要自定义颜色、渐变和标签，请单击颜色监视。

点映射选项

本部分介绍点地图图表的选项。

示例

在 “数据 ”选项卡中，单击“ + 添加 SQL 数据集”，粘贴以下查询，然后运行它：

SELECT city, latitude, longitude, population
FROM VALUES
  ('New York',     40.7128,  -74.0060, 8336817),
  ('Los Angeles',  34.0522, -118.2437, 3979576),
  ('Chicago',      41.8781,  -87.6298, 2693976),
  ('Houston',      29.7604,  -95.3698, 2320268),
  ('Phoenix',      33.4484, -112.0740, 1608139),
  ('Philadelphia', 39.9526,  -75.1652, 1603797),
  ('San Antonio',  29.4241,  -98.4936, 1434625),
  ('San Diego',    32.7157, -117.1611, 1386932),
  ('Dallas',       32.7767,  -96.7970, 1304379),
  ('San Jose',     37.3382, -121.8863, 1013240)
AS t(city, latitude, longitude, population);

在可视化编辑器中，配置以下内容：

在 “坐标”下，选择“ 经度/纬度”。
1. 在 “经度”下，单击加号图标并选择 longitude。
2. 在 “纬度”下，单击加号图标并选择 latitude。
在 “大小”下，单击加号图标并选择 population。

点地图示例，显示按人口调整大小的美国城市。

坐标

使用可视化编辑器配置坐标：

经度/纬度：选择包含地图坐标的经度和纬度组件的列。
几何图形：选择要用作点位置的 GEOMETRY 或 GEOGRAPHY 列，而不是单独的纬度和经度列。请参阅自定义地理数据。

颜色

对于未组合的数据，请单击颜色样本以更改地图上显示的点的颜色。若要应用分组策略，请单击“ 加号”图标。可视化编辑器的 “颜色” 部分中的加号图标。可以通过单击编辑器中每个组标签旁边的颜色样本来调整自动分配的颜色。

大小

单击 “加号”图标。 “ 大小 ”部分中的加号图标可选择反映数量字段，使你可以根据数据值显示不同大小的点。

自定义地理数据

可以直接从任何数据集中的 GEOMETRY 或 GEOGRAPHY 列呈现地图。使用此方法可可视化自定义形状，如销售区域、学区、商店集水区，或绘制点，而无需将坐标拆分为单独的纬度和经度列。

每个行都是独立绘制的，因此如果数据每个区域有多个行，形状或点可能会重叠。若要将行合并到每个区域的单个形状，请使用指标视图中的几何图形度量值。请参阅 “限制 ”和 “本地指标”视图。

使用几何度量值定义指标视图

在指标视图中 YAML 中，使用支持的聚合之一将几何图形或地理列设置为度量值： ST_UNION_AGG、 ST_ENVELOPE_AGG、 FIRST或 LAST。对要分组的非几何图形列使用维度。

以下本地指标视图定义为 region 维度、 total_sales 数值度量值，并用于 ST_UNION_AGG 将每行边界合并到每个区域的单个形状中：

version: 0.1
source: sales.territories

dimensions:
  - name: region
    expr: region

measures:
  - name: total_sales
    expr: SUM(sales_amount)
  - name: region_shape
    expr: ST_UNION_AGG(boundary)

如果地理数据存储为序列化字符串或二进制值，请将其 GEOMETRY 强制转换为度量值表达式或 GEOGRAPHY 将其转换为度量值表达式。

创建 choropleth 映射

Choropleth 地图支持 Polygon 和 MultiPolygon 形状。

将指标视图添加为数据集。
将可视化类型设置为 Choropleth 映射。
在 “区域”下，选择 “自定义几何图形 ”并选择几何度量值（例如， region_shape）。
在 “颜色”下，选择数字度量值，例如 total_sales。

创建点映射

点映射支持 Point 和 MultiPoint 形状。 Point使用 -valued geometry 度量值，例如FIRST(location)或 ST_UNION_AGG(location)。

将指标视图添加为数据集。
将可视化效果类型设置为 点映射。
在 “坐标”下，选择“ 几何图形 ”并选择几何度量值。
（可选）在 “大小”下，选择数字度量值以改变点大小。

局限性

GROUP BY 不支持列 GEOMETRY 或 GEOGRAPHY 列。若要将多个行组合成每个组的单个形状，请使用、ST_UNION_AGGST_ENVELOPE_AGG或FIRST将几何图形聚合为指标视图度量LAST值。否则，将独立呈现每一行，形状可能会重叠。
地图呈现器使用 WGS84 （SRID 4326）。 GEOMETRY 其他 SRID 中的列会自动重新投影; GEOGRAPHY 列必须已是 SRID 4326。如果需要，请在度量值表达式中使用 ST_Transform 重新投影。
GEOMETRY 不呈现具有 SRID 0 （未知坐标系）的列。
GeometryCollection 不支持混合多个形状类型的值和列。
使用几何图形或地理列的地图不支持标签编码。

Last updated on 2026-06-24