Mapbox词汇表中文文档(查找Mapbox相关的术语及其定义)

前言

Mapbox词汇表英文文档

本文词汇表按照字母顺序排序


A


access token (访问令牌)

要使用 Mapbox 的任何工具,APISDK ,您需要一个 Mapbox access tokenMapbox使用access tokenAPI 资源请求与您的帐户相关联。您可以在 access token page 上找到所有access token,创建新令牌或删除现有令牌。

以下是我们的 API 中的access token page
https://api.mapbox.com/v4/mapbox.emerald/page.html?access_token=pk.eyJ1Ijoiemhvbm5ncGVuZyIsImEiOiJjam5rMXhzNjYwbG1wM3BtenNpczV0NXgxIn0.RmIRNHLPKgyJtDvrWhiQQg

Public vs.secret tokens (公共vs.secret令牌)

创建访问令牌时,您可以选择为其提供一组零个或多个范围,这些范围定义该令牌可以访问哪些 Mapbox API 以及可以使用哪些方法来访问它们。

Public scopes and tokens (公共范围和令牌)

Public scopes仅允许从 API 检索数据。这些令牌放入公共应用程序更安全,因为它们不能用于更改帐户中的数据。具有公共范围的标记以 sk 开头。

创建公共令牌后,可以重命名令牌并添加和删除公共范围。秘密范围无法添加到公共令牌中。

Secret scopes and tokens (私密范围和令牌)

Secret scopes允许创建和修改对 Mapbox API 的访问以及对可能包含特定于帐户的信息的 API 的访问。这些令牌只能在安全的上下文中使用。具有私密范围的标记以 sk 开头。

创建私密令牌后,只能查看一次 - 如果您刷新或离开 API 访问令牌页面,令牌本身将消失。
可以重命名令牌,并随时添加或删除任何作用域。

Default Public Token (默认的公共令牌)

您的帐户将始终至少拥有一个Default Public Token,并将作为您的Default Public Token显示在 Mapbox网站上。
如果删除此令牌,则另一个公共令牌将成为您的Default Public Token
当您登录到您的帐户时,此令牌将自动嵌入到 Mapbox.com 上的示例代码中。

您可能还想阅读:如何创建一个API访问令牌?

annotation (标注物)

在适用于 iOS的Mapbox Maps SDK 中,annotation 是地图上的已定义位置,由自定义 UIView 或 UIImage 表示。您可以使用注释来表示点数据,例如城市中的餐馆,沿路线的公交车站或地震位置。您可以通过多种方式向地图添加注释。有关添加注释的详细信息,请参阅 Mapbox Maps SDK for iOS文档 中的添加指向地图指南。

API (应用编程接口)

API 是软件库应如何相互交互的规范。将 API 视为从网站或服务获取数据的一种方式,而无需亲自访问该网站或服务。 查看 Developers 页面上的所有 Mapbox API

查看所有的Mapbox API 开发者页面。

attribution (Mapbox的logo)

attribution 是放置在所有 Mapbox 地图上的两个视觉元素的组合,表明使用 Mapbox 工具和数据创建了地图,类似百度和高德的左下的角标。

Mapbox 要求所有地图都包含 Mapbox 字标和文本。 Mapbox 字标是一个小图像,包含程式化的单词 MapboxMapbox 徽标。

文本属性至少包含三个链接:©Mapbox,©OpenStreetMap和改进此地图。
由于 OpenStreetMap 的数据源 ODbL 许可证,使用 Mapbox Streets tileset 时严格要求此属性。
有关如何以及何时需要 attribution 的详细信息,请参阅我们的 attribution guide。


B


baselayer (基础图层)

baselayer 通常是指您在 Mapbox Studio Classic 或 Mapbox classic styles 中设计的地图样式。baselayer 提供地理上下文,并作为地图的起点。

bearing (方位)

bearing 或 航向,是你面对从正北上的罗盘的角度顺时针测得的方向,顺时针测量为指南针上的真北角(北为0°,东为90°,南为180°,和西是270°)。

bounding box (边界框)

bounding box 是用于描述地图的特定区域的机制。它通常表示为坐标对的数组,第一个坐标对指的是盒子的西南角,第二个坐标对指盒子的东北角。创建地图或启动地理编码请求的任何 Mapbox 库都有一个类或对象,用于在代码中使用bounding box:创建地图或发起地址解析请求任何 Mapbox 库中有在代码中使用bounding box类或对象:

  • Mapbox.js and Leaflet - L.LatLngBounds
  • Mapbox GL JS - LngLatBounds
  • Turf.js - turf.bbox
  • Mapbox Maps SDK for iOS - MGLCoordinateBounds
  • Mapbox Maps SDK for Android - BoundingBox class
  • Mapbox Java SDK – MapboxGeocoding.Builder.bbox() method
  • MapboxGeocoder.swift – RectangularRegion class

C


camera (摄像机)

在使用 Mapbox GL 的地图中,camera是地图的视野。camera的视口是由几个因素决定:

  • 中心:定义地图的中心坐标。
  • 缩放级别:一个数字,确定视口有多接近地图的表面。缩放级别为零将显示整个世界。缩放级别越高,视口越接近地图的表面。
  • 间距:以度为单位测量地平线的角度,范围在0到60度之间。零度会产生二维地图,就好像您的视线与地球表面形成一个垂直角度。。
  • 方位:目的地的旋转角度,以度为单位从北向逆时针测量,范围在0到360度之间。

CartoCSS

CartoCSSMapbox Studio Classic 用于构建经典样式的语言。您可以使用 CartoCSS 选择颜色,在特定缩放级别应用不同的渲染,并且通常将样式应用于矢量数据。

以下是CartoCSS样式道路标签的示例:

#road_label {
  text-name: @name;
  text-placement: line;
  text-face-name: @sans;
  text-fill: #333;
  text-halo-fill: fadeout(#fff, 75%);
  text-halo-radius: 2;
  text-halo-rasterizer: fast;
  text-size: 12;
  text-margin: 20;
  text-avoid-edges: true;
  [zoom>=15] { text-size: 13; }
}

顾名思义,CartoCSS 就像 CSS,用于 HTML 样式的语言。 CartoCSS 是地图数据的 CSS。阅读 CartoCSS 文档 以了解更多信息。

classic style (经典样式)

在 Mapbox Studio Classic 中,classic style 包含 CartoCSS 样式表,基本精简元数据(名称,描述,属性等)以及对 source的引用。 将 classic style 上传到 Mapbox.com 后,它将显示在 Classic styles page 页面上。

coordinate (坐标)

coordinate 是纬度和经度的组合。海拔高度可以作为第三个值包含在内。

CSV (逗号分隔值)

CSV (维基百科解释) 的格式对于表格数据很常见,例如您可以在 Excel 或其他电子表格中使用的格式。 CSV 文件不一定是可映射的,除非它们包含地理信息(如纬度和经度)。
阅读 CSV 文件疑难解答,了解有关如何格式化文件的示例。 Download a sample CSV file

上传 CSV 文件时,请注意以下事项:

  • 查看 Mapbox 上传 API 文档,了解 CSV 文件的当前大小限制。
  • CSV 文件必须采用 UTF-8 编码。
  • Mapbox StudioMapbox Studio Classic 中上传时,CSV 文件必须包含坐标(纬度和经度)。
  • CSV 文件仅用于点数据。
  • 通过 CSV 导入的数据将在 Mapbox Studio 数据集编辑器中编码为字符串类型。
    如果要将任何导入的数据编码为数字,可以在数据集编辑器中单独编辑字段,也可以 GeoJSON format 上传数据。

D


data-driven styling

data-driven styling 允许您根据空间数据的属性设置样式。例如,使用data-driven styling,您可以根据穿越十字路口的行人数量更改交叉点处的圆的半径,根据根据每个州的人口更改状态多边形的颜色,或使用条件逻辑创建双语标签。 Mapbox StudioMapbox GL JS,适用于 iOSMapbox Maps SDK 以及适用于 AndroidMapbox Maps SDK 均提供data-driven styling

Property functions vs property expressions(属性函数与属性表达式)

我们最近改变了data-driven styling的工作方式 - 从属性函数到属性表达式。属性表达式可帮助您实现与属性函数类似的效果,并具有更多的灵活性和功能。属性表达式在 Mapbox GL JS v0.41.0 中引入。虽然属性函数目前仍然可用,但它们最终将被弃用并由属性表达式替换。

表达式兼容:

  • Mapbox GL JS 0.41.0及以上版本。
  • Mapbox Android SDK 6.0.0及更高版本。
  • Mapbox iOS SDK 4.0.0及更高版本。

dataset (数据集合)

dataset 是 GeoJSON features 的可编辑集合。dataset可以通过 Mapbox StudioMapbox Datasets API 上传到 Mapbox ,也可以在 Mapbox Studio 数据集编辑器中进行编辑。
有关更多信息,请查看 Mapbox Studio手册。

dataset ID (数据集ID)

每次使用 Mapbox Studio数据集编辑器 创建数据集时,它都会生成dataset ID。您可以使用dataset ID Mapbox数据集API 发出与数据集相关的请求。


E


expression (表达式)

expression 定义用于计算地图样式中任何布局属性,绘制属性或过滤器的值的公式。表达式允许您一次为多个要素属性设置数据样式,应用条件逻辑,并使用数学,逻辑和字符串运算符操作数据。这允许复杂的 runtime styling。
有关在地图样式中使用表达式的更多信息,请查看 Mapbox样式规范 或 Mapbox iOS SDK表达式 参考。


F


features

features 指的是数据集或图块集中的地理空间要素。例如,表示休闲公园的单个多边形是可以属于包含城市公园多边形的数据集的特征的一个示例。

feature querying (要素查询)

feature querying 是在特定位置识别区块集中的 要素 的过程。例如,如果您有一个带有公园的图层的地图,则可以使用 Mapbox 工具查看特定坐标中是否存在公园要素。

feature querying支持许多高级地图可视化,允许用户选择特定点以发现位于下方的数据。可以使用 Mapbox GL JS ,适用于 Mapbox Maps SDK for iOS,或适用于 Mapbox Maps SDK for Android 在 Web 地图上执行要素查询。

filter (过滤器)

filter(也就是iOSmacOS中的断言)可以对样式层的内容进行细粒度控制。从 GeoJSON 或矢量源获取其功能的样式图层仅包含满足您定义的过滤器或断言条件的功能。
有关更多信息,请参阅过 过滤器 和 断言的文档。

font stack (字体堆)

font stack 是包含主要字体和可选后备字体的字体的有序列表,如图层中所定义。在字体堆中,主要和后备字体的组合定义了渲染器应尝试查找图层中使用的字符的顺序。如果在第一个font stack中找不到字符,渲染器将尝试使用下一个字符,直到找到一个。

看完上面官方的描述可能有点懵来看段 ccs 样式:

body {
    font-family: Georgia, "Times New Roman", serif;
}

上面的就是所以的font stack,浏览器在加载样式的时候会先从 font-family的属性后面的第一个开始匹配,如果第一个 Georgia 字体找到了,那后面的就不会在找了,如果第一个字体没有找到,浏览器将尝试找下一个字符,直到找到一个为止。

样式对象本身没有font stack
相反,单个图层具有自己的font stack,这些font stack在符号图层的 text-font 属性中定义,如 Mapbox样式规范 中所述。

您可以管理样式中使用的font stack,以缩短渲染时间并减小离线地图的大小。


G


geocoding (地理编码)

geocoding 是获取地点的地址或名称并将其转换为纬度和经度值的过程。 Mapbox geocoding API 允许您执行两种类型的地理编码:Forward geocoding(地理编码)Reverse geocoding(逆向地理编码)

Forward geocoding 将文本转换为地理坐标。
例如,将2 Lincoln Memorial Circle NW的地址转换为-77.050,38.889的坐标值。

Reverse geocoding 将地理坐标转换为文本描述,例如,将-77.050,38.889转换为2 Lincoln Memorial Circle NW的地址。

有关更多信息,请参阅 Mapbox地理编码API文档。

GeoJSON

GeoJSONMapbox Web 服务和 API 提供的地图数据的文件格式。作为 JSON 格式的子集,它可以在现代软件中解析,并且可以使用 JavaScript 语言本地化。

您可以将 GeoJSON 文件上传到 Mapbox 帐户,以便在自定义地图样式中使用。有关详细信息,请参阅 Mapbox Studio 手动上载页面。下面是一个示例 GeoJSON 文件供参考。 Download a sample GeoJSON file

有几种开源工具可用于将其他地理空间数据格式转换为 GeoJSON
比较受欢迎的有:

  • togeojson,一个用于转换KML和GPX(XML格式)的节点包。
  • ogr2ogr,最终的40合1矢量数据转换工具。
  • geojson.io, 用于创建,转换和编辑 GeoJSON

GPX

GPX 或GPS交换格式是通常由GPX接收器创建的数据格式。

您可以将 GPX 文件上传到 Mapbox 帐户,以便在自定义地图样式中使用。有关详细信息,请参阅 Mapbox Studio手动上传页面。下面是一个示例 GPX 文件供参考。

请注意,Mapbox 不支持沿线的值(例如,沿着慢跑路线的各个点的海拔和时间)。可以上载沿一行的值的 GPX 文件,但 Mapbox 将忽略该行的任何数据。
Download a sample GPX file


I


iframe

注意:不推荐使用Mapbox编辑器。
您可以在 此处 找到现有项目。
有关更多信息,请参阅我们的 公告 和 迁移Mapbox编辑器项目 指南。

Mapbox 编辑器会为您生成嵌入代码,以便将地图添加到您的网站或博客中。嵌入代码使用