前言
本文词汇表按照字母顺序排序
A
access token (访问令牌)
要使用
Mapbox
的任何工具,API
或SDK
,您需要一个Mapbox
access token。Mapbox
使用access token将API
资源请求与您的帐户相关联。您可以在 access token page 上找到所有access token,创建新令牌或删除现有令牌。
以下是我们的
API
中的access token page: api.mapbox.com/v4/mapbox.e…
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
字标是一个小图像,包含程式化的单词Mapbox
和Mapbox
徽标。 文本属性至少包含三个链接:©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
CartoCSS 是
Mapbox 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 Studio
或Mapbox Studio Classic
中上传时,CSV
文件必须包含坐标(纬度和经度)。CSV
文件仅用于点数据。- 通过
CSV
导入的数据将在Mapbox Studio
数据集编辑器中编码为字符串类型。 如果要将任何导入的数据编码为数字,可以在数据集编辑器中单独编辑字段,也可以 GeoJSON format 上传数据。
D
data-driven styling
data-driven styling 允许您根据空间数据的属性设置样式。例如,使用data-driven styling,您可以根据穿越十字路口的行人数量更改交叉点处的圆的半径,根据根据每个州的人口更改状态多边形的颜色,或使用条件逻辑创建双语标签。
Mapbox Studio
,Mapbox GL JS
,适用于iOS
的Mapbox Maps SDK
以及适用于Android
的Mapbox 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 Studio
或Mapbox Datasets API
上传到Mapbox
,也可以在Mapbox Studio
数据集编辑器中进行编辑。 有关更多信息,请查看 Mapbox Studio