前言
Mapbox词汇表英文文档
本文词汇表按照字母顺序排序
A
access token (访问令牌)
要使用
Mapbox
的任何工具,API
或SDK
,您需要一个Mapbox
access token。Mapbox
使用access token将API
资源请求与您的帐户相关联。您可以在 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
字标是一个小图像,包含程式化的单词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手册。
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(也就是
iOS
和macOS
中的断言)可以对样式层的内容进行细粒度控制。从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
GeoJSON 是
Mapbox 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
编辑器会为您生成嵌入代码,以便将地图添加到您的网站或博客中。嵌入代码使用来显示您的地图。 此
HTML
元素允许您将网页放入另一个网页,从而使您的地图的所有代码与您网站上的代码隔离开来。
K
KML
KML 是一种类似
GeoJSON
的文件格式,但在GeoJSON
一样,它可以存储点,线,多边形和其他矢量数据。与GeoJSON
不同,它基于XML
而不是JSON。
您可以将
KML
文件上传到Mapbox Studio
,以将自定义数据添加到地图中。
当您上传KML
文件时,Mapbox
会将您的数据转换为矢量切片,以便您可以从中创建样式。
上传
KML
时,请注意Mapbox
不支持任何KML
扩展。有关上载shapefile
的更多信息,请查看 Mapbox Studio手册上传页面。 Download a sample KML file
L
Landsat-live
Landsat-live 拥有世界各地的最新卫星图像。在过去32天内捕获每个像素并直接渲染到我们的图层中。
要在项目中使用图像,可以使用
mapbox.landsat-live
map ID 将其添加到Web
地图或移动应用程序中。
您还可以使用
mapbox.landsat-live-vt
map ID 为矢量流添加矢量轮廓和元数据流。
latitude and longitude (纬度和经度)
latitude and longitude 是用于描述 地理坐标系 平面上的位置的一对数字(坐标)。数字为十进制度数,纬度为-90至90,经度为-180至180。
例如,华盛顿特区的纬度为38.8951,经度为-77.0364。在
API
调用中,您经常会看到数字放在一起并用逗号分隔:-77.0364,38.8951。
一个常见问题是混合坐标的顺序。一些工具和API格式化经度,纬度,而其他工具和
API
使用纬度,经度。请务必查看文档以了解如何格式化坐标。如果一个点没有显示您期望的位置 - 通过切换顺序进行故障排除!
layer (层)
在 样式 中使用图层将样式规则添加到特定的 数据 子集。 (例如,如果您希望地图中的所有河流都是粉红色的,那么您可以为它创建一个样式的图层。)图层包含对数据的引用,它们用于定义样式以及样式要应用的规则。
阅读有关 Mapbox样式规范 中图层的更多信息。
layout and paint properties (布局和绘制属性)
layout and paint properties 是图层的两个子属性,用于定义在 Mapbox GL 贴图中如何渲染空间数据。
layout properties 定义如何绘制该图层的数据,并在渲染过程中应用。布局属性的示例包括可见性,线帽和符号放置。
paint properties 定义如何设置该图层的数据样式,并在稍后的渲染属性中应用。涂料属性的示例包括填充颜色,背景图案和线条不透明度。
有关layout and paint properties的更多信息,请参阅 Mapbox样式规范。
Leaflet
Leaflet 是一个开源的
Web
映射库,它构成了Mapbox.js
的基础。它是在网页上运行的软件,可以使交互式地图成为可能。Leaflet
从Mapbox
等服务器请求切片,显示和动画它们,并支持其他叠加。
M
Maki
Maki 是
Mapbox
为地图设计师开发的一个图标集。它包括公共兴趣点图标,如公园,餐馆,露营地等。Mapbox Studio
中的每个Mapbox
模板样式都包含一组风格独特的 Maki 图标。
map ID (地图ID)
每当您将数据作为图块集上传到您的帐户时,都会获得一个 map ID。map ID还用于标识使用旧版
Mapbox
编辑器创建的项目以及使用Mapbox Studio Classic
创建的样式。
地图ID将始终以您的
Mapbox
用户名开头,后跟您的tileset
的唯一句柄:username.handle
。请注意,在Mapbox Studio
样式编辑器中创建的样式和上载到Mapbox Studio
或通过Mapbox Studio
数据集编辑器创建的数据集没有map ID - 它们用 style URLs 和 dataset IDs 标识。
您可以使用 Mapbox Maps API 直接请求
tileset
。
map view
Web
地图由单独的切片组成,可在浏览器中快速有效地呈现。当用户通过平移或缩放与地图交互时,会加载更多图块。要跟踪地图的使用情况,已加载的切片数将计为 map view。
瓦片可以通过三种方式呈现:
- Mapbox Studio Styles
- Mapbox Static API
- Mapbox Classic Styles
每种方法的地图视图都有所不同
Mapbox Studio Styles (4 tiles)
使用
Mapbox Studio
样式时,在视口中加载四个图块时会记录单个地图视图。当用户缩放经过缩放16时,可以节省过度索引以节省切片负载。
Mapbox Static API (1 request)
当您对
Mapbox Static API
发出单个请求(用于创建静态地图图像)时,会计算一个地图视图。
Mapbox Studio Classic (15 tiles)
如果您使用了 Mapbox编辑器 项目或 Mapbox Studio Classic 样式,则在地图上加载15个图块时会计算地图视图。
这些计数通常适用于大多数网站上的单页面视图。当用户与地图交互时,可以在单个会话期间生成多个地图视图。
为什么
Mapbox
工具中每个地图视图的切片数量不同?来自Mapbox Studio
样式的图块覆盖更多像素,使得Mapbox Studio
样式中的四个图块大致相当于来自Mapbox Editor
项目和Mapbox Studio Classic
样式的15个图块。
请参阅我们的 定价页面 ,了解您的计划包含的地图视图数量。如需大批量年度折扣,请联系我们的销售团队,详细了解我们的定制计划产品。
对于本机移动应用程序和
Unity
应用程序,Mapbox
通过每月活跃用户而不是地图视图来计算使用情况。
Mapbox Maps SDK for Android
适用于
Android
的Mapbox Maps SDK
是一个开源工具集,用于为Android
设备构建地图应用程序,具有极大的视觉样式和可定制性灵活性。
- Maps SDK for Android文档
- GitHub上的Maps SDK for Android
- 开始使用Android的Mapbox Maps SDK
Mapbox Maps SDK for iOS
适用于
iOS
的Mapbox Maps SDK
是一个开源工具集,用于为iPhone
和iPad
设备构建地图应用程序,具有极大的视觉样式和可定制性灵活性。
- Maps SDK for iOS 文档
- Maps SDK for iOS on GitHub
- 开始使用ios的Mapbox Maps SDK
Mapbox Directions API (路线)
借助
Mapbox Directions API
,您可以向地图添加带有转弯路线的路线。 Mapbox提供三种不同的配置文件:驾驶,步行和骑自行车。
有关更多信息和示例,请查看:
- 路线API文档
- 路线 API入门
- 路线 API的GL JS插件
- Mapbox 路线 API的Leaflet插件
- Mapbox.js和路线 API插件示例
Mapbox Editor(一个过期的地图编辑器)
注意:不推荐使用
Mapbox
编辑器。您可以在 这里 找到现有项目。有关更多信息,请参阅我们的 公告 和 迁移Mapbox编辑器项目指南。
Mapbox Editor 是一个用于设计地图的在线界面。
Mapbox 编辑器
不再处于快速迭代开发阶段。
有关我们最新的地图设计工具,请查看 Mapbox Studio。
Mapbox GL
Mapbox GL 是一套开源库,用于在
Web
,移动和桌面应用程序中嵌入高度可定制和响应的客户端映射。地图以超高帧速率渲染。您可以使用Mapbox Studio
中设计的自定义样式。您还可以动态操作样式外观的各个方面,因为 Mapbox GL 渲染矢量切片。缩写GL
来自OpenGL
,行业标准的开放图形库。
Mapbox GL
在以下平台上得到官方支持:
- 在
Web
上,使用 Mapbox GL JS。- 在
Android
上,使用 Mapbox Maps SDK for Android。- 在
iOS
上,使用 Mapbox Maps SDK for iOS。- 在
Qt
上,使用 Mapbox Maps SDK for Qt (Qt Location Mapbox GL Plugin)。
本机 macOS
应用程序可以使用社区维护 Mapbox Maps SDK for macOS
如果您希望将
Mapbox
地图合并到混合Android
或iOS
应用程序中,请查看我们关于构建 混合应用程序 的页面。请注意,我们无法为混合框架提供支持。
Mapbox GL JS
Mapbox GL JS 是一个使用
Mapbox GL
渲染交互式地图的JavaScript
库。它可以免费使用。
您可以将
Mapbox Studio
创建的 Mapbox 样式 或 自定义样式 添加到 Mapbox GL JS 应用程序中。
Mapbox.js
Mapbox.js 是一个
JavaScript
库,允许您向网站添加交互式地图。它是Leaflet
的插件,是一个可以免费使用的开源库。
您可以将任何 Mapbox Studio style 或 Mapbox Studio Classic style 用作
Mapbox.js
中的底图。有关更多信息,请参阅 Mapbox.js文档。
Mapbox Map Matching API
Mapbox Map Matching API 允许您记录记录的迹线,例如
GPS
跟踪器中的数据,并将它们捕捉到OpenStreetMap
道路和路径网络。这有助于对齐嘈杂的轨迹并在地图上干净地显示它们。
Mapbox Maps SDK for React Native
适用于
React Native
的Mapbox Maps SDK
是一个跨平台解决方案,提供可重用的JavaScript
组件,用于构建Android
和iOS
应用程序中的映射和位置。
- Maps SDK for React Native文档
- 适用于React Native的Maps SDK
- 开始使用 React Native Maps SDK
Mapbox Maps SDK for Unity
Mapbox Maps SDK for Unity 是一组用于从真实地图数据构建 Unity
应用程序的工具。它包含一个强大的 API
,用于连接 Mapbox Web
服务,将地图资源转换为游戏对象,以及构建在 Unity
平台之上的强大的图形用户界面。
要在您的应用程序中包含Mapbox Maps SDK for Unity,请访问文档页面以获取安装说明,API参考和教程:
- Mapbox Maps SDK for Unity概述
- API文档
- 教程
- Unity应用的定价
Mapbox Matrix API (矩阵)
Mapbox Matrix API(以前称为距离 API)计算一个API请求中多个点之间的行程时间。
Matrix API
返回多个位置之间的行程时间,专门用于构建时间表或矩阵。多播源和目标的数量以创建矩阵或时间表,并计算发出请求所需的元素数量。例如,给定3个位置A,B,C,Matrix API
将返回所有位置之间所有行程时间(以秒为单位)的矩阵:
A | B | C | |
---|---|---|---|
A | A → A | A → B | A → C |
B | B → A | B → B | B → C |
C | C → A | C → B | C → C |
Matrix API
适用于全球范围,可用于驾驶,骑行和步行路线配置文件。详细了解Mapbox Matrix API
工作原理教程 。Mapbox Matrix API
适用于所有计划级别。
Mapbox Matrix API elements
Mapbox Matrix API 处理不同大小的批量请求,因此会根据返回的元素数量而不是请求来跟踪 计费
。
例如,来自Matrix API
的一个请求可以是许多不同的源和目标对,因此来自Matrix API
的一个请求等于源的数量乘以目的地的数量(例如:2个源x 3个目的地等于6个元素)。
阅读有关
Mapbox Matrix API
如何在我们全面的方向工作指南中工作的 更多信息。
Mapbox Navigation SDK (导航)
Mapbox Navigation SDK 构建于
Mapbox Directions API
之上,Mapbox Navigation SDK
包含以下关键功能:
- 插入式的turn-by-turn导航UI。
- 汽车,自行车和步行路线。
- 避免交通堵塞。
- 机动公告。
- 文字说明。
- 文本到语音支持。
- 自动重新规划路线。
- 快速路线。
要在应用程序中包含
Mapbox Navigation SDK
,请访问相应的文档页面以获取安装说明,API参考和示例代码:
- Mapbox Navigation for iOS
- Mapbox Navigation for Android
Mapbox Satellite (卫星)
Mapbox Satellite 是高分辨率卫星图像的全球底图。 图像数据来自各种商业提供商,以及来自
NASA
,USGS
和其他公司的开放数据。 它经过颜色校正并混合在一起成为一个光栅图块集。
Mapbox Satellite 免费提供给
Mapbox Studio
样式编辑器中缩放级别0-19的所有用户,以及使用样式URL mapbox:// styles / mapbox / satellite-v9或map ID mapbox.satellite的API和SDK。
Mapbox Static API
您可以使用 Mapbox Static API 生成地图的静态图像。 这是在没有
JavaScript
或插件的情况下将地图添加到您的网站或博客的好方法。 每个静态地图图像都计为1个地图视图。
如果您正在使用
Mapbox Studio
中的样式,则可以使用Static API
检索静态图像。
如果您使用的是
Mapbox Studio Classic
、Mapbox Editor
、Mapbox map ID
,请使用Classic Static API
。
要了解更多信息,请阅读 创建静态地图。
Mapbox Studio Classic
Mapbox Studio Classic 是一个用于设计地图的桌面应用程序。 它允许您使用矢量切片和
CartoCSS
创建地图。 Mapbox Studio Classic 允许您以MBTiles
格式将地图直接导出并上传到Mapbox
帐户,然后与我们的开发人员工具一起使用。
创建新地图?
Mapbox Studio
是 Mapbox Studio Classic 的现代替代品。 如果您今天开始创建地图,我们建议您使用Mapbox Studio
而不是 Mapbox Studio Classic。
Mapbox Studio
Mapbox Studio 是一个用于创建自定义地图的
Web
应用程序。 您可以管理和创建数据集,切片集和地图样式。
要开始使用
Mapbox Studio
,请查看 Mapbox Studio手册。
Mapbox Uploads API (上传)
使用 Mapbox Uploads API,您可以将
Mapbox
强大的数据上传功能集成到您的应用程序中。 我们提供临时凭证以在S3
上暂存空间文件,然后将其处理为Mapbox GL和Mapbox.js
可读的栅格切片或Mapbox
矢量切片。
API支持各种空间文件类型,包括GeoJSON, KML, GPX, Shapefiles, CSV, GeoTIFF, and MBTiles 我们不断增加对更多类型和更大文件的支持。
Mapbox web services (Mapbox Web服务)
Mapbox Web服务 是
Mapbox
的最低级别接口 - 它们是我们的JavaScript
,Objective-C
和其他系统构建的API
。
您可以从任何语言或环境连接到 Mapbox Web服务 - 您可以使用
Python
请求模块,node.js
请求模块,用于Ruby
的HTTParty
或您选择的语言的其他HTTP
请求库。
mapnik
Mapnik 是一个开源地图工具包,用于桌面和基于服务器的地图渲染,为空间数据访问和可视化提供算法和模式。 它是地理对象的集合,如地图,图层,数据源,要素和几何。
Mapnik 用于在从 Mapbox Maps API 请求切片时呈现 classic styles。 它还用于在 Mapbox Studio Classic 中渲染地图。
marker (地图中的标记)
在
Web
地图中,标记通常是地图上特定坐标的直观表示。 可以通过各种方式添加和自定义标记,以便在Mapbox Web
地图和移动应用程序中使用。 您可以在我们的添加自定义图标和 标记指南 中阅读有关可视化点数据的选项以及查找分步教程的更多信息。
MBTiles
MBTiles 是用于存储
tileset
的文件格式。 它的设计使您可以打包组成tileset
的潜在数千个文件并移动它们,最终上传到Mapbox
或在Web
或移动应用程序中使用。MBTiles
是一个开放的规范,基于SQLite
数据库。MBTiles
可以包含栅格或矢量tileset
。
您可以导出
MBTiles
格式的Mapbox Studio Classic
源以直接上载到Mapbox Studio
。 有关详细信息,请参阅 Mapbox Studio 手动上载页面。
下面是一个示例MBTiles文件供参考。
Download sample MBTiles
monthly active users (月活跃用户)
对于使用适用于
iOS
,Android
,React Native
或Unity
的Mapbox Maps SDK
构建的本机移动应用程序,我们会跟踪每月活跃用户(MAU)
,也称为移动用户,而不是地图视图。 这是在给定月份内访问应用程序中的地图的用户数。
请参阅我们的定价页面,了解您的计划包含的移动用户数量。 如果没有符合您需求的计划,请联系我们的销售团队 以了解有关我们的自定义计划产品。
对于使用任何其他API构建的地图,我们会计算 每月地图视图。
O
offline regions and offline packs (离线区域和离线包)
offline regions(也称为适用于
iOS
的Mapbox Maps SDK
中的脱机包)是地图的已定义区域,可用于具有有限网络连接或无网络连接的条件,使用适用于 Mapbox Maps SDK for iOS 和 Mapbox Maps SDK for Android。 有关更多信息,请查看我们的离线地图指南。
OpenStreetMap (OSM维基百科)
OpenStreetMap 是一个合作项目,以创造一个自由编辑地图的世界,任何人都可以向该地图贡献数据。OpenStreetMap 的数据可以免费共享和使用。
Mapbox Streets tileset
源数据源自OpenStreetMap。 为Directions API
和相关API
提供支持的路由网络也基于OpenStreetMap。
overzoom
Overzoom 是
tileset
被放大超出其给定缩放范围的结果。
如果出现 Overzoom ,则光栅图块集将显得不清晰。 例如,如果要显示
z0
和z6
之间缩放范围的光栅图块集,如果缩放到z6
之后的更高缩放级别,图像将变得模糊且难以看清。
由于矢量数据不是以基于像素的格式存储,而是从一系列点,线和多边形进行编码和计算,因此过度变换的效果对于矢量图块集并不明显。 因此,矢量数据可以被过度显示并可视化以进行缩放22。
P
projection (投影)
projection 是将行星上的位置坐标转换为二维平面的方法。
Mapbox
支持流行的 Web Mercator projection。Web Mercator
被绝大多数Web
地图采用,它的使用允许您将Mapbox
地图与同一投影中的其他图层结合使用。
Q
quadtree
quadtree 是树数据结构,其中每个节点恰好有4个子节点。 quadtree允许您放大和缩小地图。 随着缩放级别的改变,四边形会更改以显示更多(或更少)细节。
R
raster data (栅格数据)
raster data 是一种基于像素的数据格式,可有效地表示连续曲面。 光栅中的信息存储在网格结构中,每个信息单元或像素具有相同的大小和形状,但值不同。 所有数码照片都以这种格式存储,也称为位图。 这包括卫星图像和正射摄影。
您可以将raster data上传到
Mapbox Studio
,以将自定义数据添加到地图中。 有关raster data的更多信息,请查看 Mapbox Studio手动上载页面。
routing profile (路线配置文件)
routing profile 是路线引擎(如
Mapbox Directions API
)用于查找两点之间的最佳路由的一组规则。 routing profile通常针对用于在位置之间进行的运输模式进行优化。
有关
Mapbox Directions API
中使用的路由配置文件的详细信息,请参阅 文档 。
runtime styling (运行时样式)
runtime styling 允许您实时动态更改
Mapbox
地图上显示的地图样式,允许您自定义地图外观的每个方面,直至最小的细节。
您可以更改地图以响应用户交互,上下文,或通过在运行时访问地图的各个层来构建复杂的数据可视化。 例如,您可以根据一天中的时间使地图变亮或变暗,根据用户活动个性化公园的颜色,甚至根据用户偏好更改标签语言。
您可以在
Mapbox Studio
中设计任何内容,也可以通过代码实现。 所有依赖 Mapbox GL 的产品都提供运行时样式。
S
shapefile
shapefile 也称为
Esri shapefile
,是用于存储地理矢量数据的文件格式。
您可以将shapefile上传到
Mapbox Studio
,以将自定义数据添加到地图中。 上传shapefile时,Mapbox
会将数据转换为矢量切片,以便您可以从中创建样式。
上传
shapefile
时,请记住以下几点:
- 查看Mapbox Uploads API文档,了解shapefile的当前大小限制。 请注意,此限制适用于shapefile的未压缩大小,而不是压缩
zip
的大小。- shapefile由几个单独的文件组成,在上传之前应该将它们组合成一个
zip
文件。 在这些文件中,Mapbox
可以读取shp
,shx
,dbf
,prj
和index
文件。 使用zip
文件上传的任何其他文件都将被忽略。
有关上载shapefile的更多信息,请查看Mapbox Studio手册上传页面。
Download a sample shapefile
simplestyle
Simplestyle 是一种用于样式化
GeoJSON
数据的开源规范。
source layer (资源图层)
source layer 是矢量资源中的特定图层。 矢量资源可以有多个层。 您可以在以下几个位置找到source layer的名称:
- 特定
tileset
的tileset
信息页面。- 在
Mapbox Studio
的样式编辑器使用Select data tab。- 在
Mapbox Studio
样式编辑器中,使用工具栏中的Style reference选项。
Tileset 信息页面
要在tileset中查找源图层:
- 访问您的Tilesets页面。
- 单击其中一个tileset的名称。
- 将打开tileset信息页面,您可以在Layer details标题下找到源图层。
在Mapbox Studio样式编辑器中选择data
要查找Mapbox样式中使用的源图层的名称,请执行以下操作:
- 在Mapbox Studio样式编辑器中打开样式。
- 单击图层列表中图层的名称。
- 切换到Select data选项卡。
- 找到tileset源名称下面列出的源图层。
在下面的示例中,图层名为place-city-label-major,源图层是Mapbox Streets图块集源中的place_label图层。
Mapbox Studio Style editor中的样式引用
要查找Mapbox样式中使用的源图层的名称,请执行以下操作:
- 在Mapbox Studio样式编辑器中打开样式。
- 单击右上方工具栏中的样式参考选项。
在下面的示例中,源图层称为waterway_label,该图层称为waterway-label。
source (数据源)
source 提供要在Mapbox GL的地图上显示的数据。 source由
Mapbox
样式规范定义,并与样式层一起使用,以直观地表示地图上的source数据。 根据您正在开发的平台,可能不支持特定的source类型,因此在向地图添加source时请参阅特定于平台的文档。
sprite
sprite 是包含样式中包含的所有图标的单个图像。 sprite通常用于网络开发甚至视频游戏,以提高性能。 通过将大量小图像组合成单个图像(sprite),您可以减少获取所有图像所需的请求数量,从而提高性能并使地图更快。
如果您使用的是
Mapbox Studio
,则无需担心sprite的技术基础:上传SVG
图标会自动创建地图将使用的sprite。 同样,所有Mapbox
模板样式都带有自己的sprite,其中包含可以与该样式一起使用的图标。 调试面板中的Images选项显示sprite中使用的像素数量。
如果您想自己动手或者对引擎盖下的内容感兴趣,您也可以创建自己的sprite。 这是所有术语和sprite如何工作的概述。
sprite将许多图标组合成一个图像:
图标是sprite中的单个图像:
sprite限制为500个图标。 每个图标最大可以为512x512像素,最大文件大小为400KB。 每个sprite都有一个免费的
JSON
文件,用于定义每个图标,包括图标在sprite中的大小和位置 - 有点像每个图标的方向:
"airport-15": {
"width": 42,
"height": 42,
"x": 76,
"y": 300,
"pixelRatio": 2,
"visible": true
}
这意味着您可以按名称引用图标,例如
airport-15
,我们的地图渲染器将引用JSON
文件以获取有关图标的数据,然后仅显示该特定图标的sprite。
要了解有关创建和编辑sprite的更多信息,请查看Mapbox 样式参考:sprite。
style ID
style ID 是与任何
Mapbox
用户名关联的每种样式的唯一标识符。 要使用Mapbox
样式API
,您需要知道正在使用的地图样式的style ID。
每次使用
Mapbox Studio
创建样式时,它都会生成样式URL
。 样式URL
包括style ID(mapbox://styles/{username}/{style_ID}).。 例如,在以下样式URL中,mapbox
是用户名,light-v9是样式ID
mapbox://styles/mapbox/light-v9
学习更多 style URL
style-optimized vector tiles (优化矢量切片)
通过
Mapbox Maps API
提供的style-optimized vector tiles会删除切片中未由Mapbox
样式表示的任何图层或特征。 style-optimized vector tiles较小,通过线上服务,是减少离线缓存大小的好方法。
例如,假设您的样式引用了具有四个图层的图块集:露营地,山脉,林地和建筑物。 最终地图包括露营地图标,森林图案和蓝山图案,但不使用建筑物。 在普通的
Mapbox GL
地图中,加载的图块包括所有四个图层,即使它们并非全部都需要。 风格优化的矢量瓷砖仅包括露营地,林地和蓝山。 它会根据属性和缩放级别删除未使用的图层和要素。
您可以在
Mapbox GL JS
中使用style-optimized vector tiles,方法是在样式URL
的末尾添加?optimize = true:
var map = new mapboxgl.Map({
container: 'map',
style: 'mapbox://styles/mapbox/outdoors-v9?optimize=true' // optimize=true
});
style URL
每次使用
Mapbox Studio
创建样式时,它都会生成style URL。 style URL允许您使用Mapbox GL JS API
或本机SDK
引用该特定样式。
您可以在
Mapbox Studio
的 Styles page 上找到样式URL
。 单击样式旁边的 Menu 按钮以显示其样式URL
。 单击图标以复制样式URL
。
style (样式)
style 是定义地图视觉外观的文档。 样式使用
Mapbox Studio
样式编辑器创建或单独编写并上载到您的帐户。 它们遵循Mapbox
样式规范,并包含有关数据源,样式图层,精灵(sprite),字形和元数据的信息。 style 由Mapbox GL JS
,适用于 Mapbox Maps SDK for Android ,适用于 Mapbox Maps SDK for iOS 或 Mapbox Static API。
有关样式的更多信息,请查看 Mapbox Studio手册。
SVG (可缩放矢量图形)
SVG 是一种用于描述二维矢量图形的标记语言。
您可以在
Mapbox Studio
样式编辑器中将SVG图像上载到自定义样式。 您可以单击调试面板中的 Images 选项来管理您的样式中的SVG。
请参阅以下指南以开始使用:
在Mapbox Studio 和 Mapbox GL JS 中自定义标记
故障排除:Mapbox Studio中的SVG资源错误
Download sample SVG image
T
telemetry (测量)
telemetry 是一个过程,其中自动传感器通过收集关于人们移动的位置和方式的匿名数据来创建和更新地图。 这对于发现丢失的道路,跟踪交通信息等非常有用。
TIFF (文件格式)
TIFF(有时是TIF)是用于保存光栅图像的文件格式。 使用
Mapbox
,TIFF通常是GeoTIFF
,这意味着文件嵌入了地理配准信息。
您可以在
Mapbox Studio
中将TIFF文件作为tileset
上传,并在Mapbox Studio
样式编辑器中使用它们。
您还可以将TIFF文件导入
Mapbox Studio Classic
并以此方式上传到Mapbox
作为tileset
。 上传TIFF文件时,请记住TIFF文件当前的大小限制。
Download a sample TIFF file
TileJSON
TileJSON是一种用于描述
tileset
的格式。 它会跟踪请求tileset
的位置,tileset
的名称以及使用tileset
时所需的任何属性。 您可以使用 Mapbox Maps API 检索TileJSON元数据。
TileMill
TileMill 是一个用于设计地图的桌面应用程序。 TileMill不再处于积极开发阶段。 对于我们最新的地图设计工具,请检查和Mapbox Studio。
tileset
tileset 是一组光栅或矢量数据,分为22个预设缩放级别的均匀方块网格。 tileset在
Mapbox
库和SDK
中用作在移动设备或浏览器中显示地图的核心部分。 它们也是我们用于确定地图视图的主要机制。
tileset可高度缓存并快速加载。
Mapbox
在很大程度上依赖于栅格和矢量tileset来保持我们的地图快速高效。 有关使用tileset的更多信息,请查看Mapbox Studio手册。
Tilesets可以是Raster或Vector。 差异概述如下:
Raster tilesets (栅格)
将光栅图像作为
TIFF / GeoTIFF
上传到Mapbox Studio
时会创建光栅图块集。 它们在现代和经典Mapbox
工具中使用,将地图显示为可在必要时在地图上加载的图像网格。 您可以在Mapbox Studio, Mapbox GL JS, 和 Mapbox Mobile SDKs 中使用Raster tilesets。
传统的Web地图库(如
Mapbox.js
和Leaflet
)也使用栅格切片在网页上显示地图。Mapbox Studio Classic
中创建的所有经典样式也包含Raster tilesets。
Vector tilesets (矢量)
Vector tilesets 是栅格tilesets的矢量数据 - 不是以像素的形式存储栅格数据,Vector tilesets 以点,线和多边形的形式存储矢量数据作为矢量tile。 Vector tilesets可以被操纵和查询。 它们可以用作样式的来源或直接查询以使用 Mapbox Mobile SDKs 和 Mapbox GL JS 创建交互式体验。
将矢量数据(GeoJSON, Shapefile, KML, 或 GPX)上传到
Mapbox
帐户时,您的数据会自动转换为矢量图块集。
Turf.js
Turf.js 是一个用于空间分析的
JavaScript
库。 它包括传统的空间操作,用于创建GeoJSON
数据的辅助函数,以及数据分类和统计工具。 Turf.js可以作为客户端插件添加到您的网站,或者您可以使用Node.js
运行Turf
服务器端。 你可以在GitHub上找到源代码。
V
vector tiles (矢量切片)
vector tiles 是一种轻量级数据格式,用于存储地理空间矢量数据,例如点,线和多边形。
Mapbox
几乎在我们所有的工具和服务中使用vector tiles。
vector tiles根据矢量图块规范对地理信息进行编码,是矢量图块集背后的关键成分。 您可以在我们的开发者页面上详细了解vector tiles的工作原理以及创建vector tiles的工具。
Z
zoom extent (缩放范围)
zoom extent 是图块集可见的缩放级别范围。 您可以通过从 Tilesets page 中选择
tileset
来查看tileset
的zoom extent。
在
Mapbox Studio
中创建切片集时,会指定缩放范围以限制其可见性并确保地图数据有效呈现。 通过仅在某些缩放级别渲染tileset
,较低分辨率的数据将不会出现在较高的缩放级别,并且详细数据不会以较低的缩放级别混乱地图。 如果要更改tileset
的缩放范围,可以使用 其他Mapbox工具。
zoom level (缩放级别)
zoom level 决定了地图的可见程度:在缩放级别0,您可以看到整个世界,在缩放级别16,您可以看到一条小路。 该数据存储在 quadtree 数据结构中。 缩放级别还会影响加载的矢量切片的大小。
到此Mapbox词汇表相关的术语翻译完成,欢迎 指正。