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

前言

Mapbox词汇表英文文档css

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


A


access token (访问令牌)

要使用 Mapbox 的任何工具,APISDK ,您须要一个 Mapbox access tokenMapbox使用access tokenAPI 资源请求与您的账户相关联。您能够在 access token page 上找到全部access token,建立新令牌或删除现有令牌。java

如下是咱们的 API 中的access token pageapi.mapbox.com/v4/mapbox.e…node

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

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

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

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

建立公共令牌后,能够重命名令牌并添加和删除公共范围。秘密范围没法添加到公共令牌中。ios

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

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

建立私密令牌后,只能查看一次 - 若是您刷新或离开 API 访问令牌页面,令牌自己将消失。 能够重命名令牌,并随时添加或删除任何做用域。github

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

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

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

annotation (标注物)

在适用于 iOS的Mapbox Maps SDK 中,annotation 是地图上的已定义位置,由自定义 UIViewUIImage 表示。您可使用注释来表示点数据,例如城市中的餐馆,沿路线的公交车站或地震位置。您能够经过多种方式向地图添加注释。有关添加注释的详细信息,请参阅 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 ClassicMapbox classic styles 中设计的地图样式。baselayer 提供地理上下文,并做为地图的起点。

bearing (方位)

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

bounding box (边界框)

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


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 (数据集合)

datasetGeoJSON 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 AndroidWeb 地图上执行要素查询。

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 编辑器会为您生成嵌入代码,以便将地图添加到您的网站或博客中。嵌入代码使用 <iframe> 来显示您的地图。 此 HTML 元素容许您将网页放入另外一个网页,从而使您的地图的全部代码与您网站上的代码隔离开来。


K


KML

KML 是一种相似 GeoJSON 的文件格式,但在 Google 产品中更经常使用。与 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 的基础。它是在网页上运行的软件,可使交互式地图成为可能。 LeafletMapbox 等服务器请求切片,显示和动画它们,并支持其余叠加。


M


Maki

MakiMapbox 为地图设计师开发的一个图标集。它包括公共兴趣点图标,如公园,餐馆,露营地等。 Mapbox Studio 中的每一个 Mapbox 模板样式都包含一组风格独特的 Maki 图标。

map ID (地图ID)

每当您将数据做为图块集上传到您的账户时,都会得到一个 map IDmap ID还用于标识使用旧版 Mapbox 编辑器建立的项目以及使用 Mapbox Studio Classic 建立的样式。

地图ID将始终以您的 Mapbox 用户名开头,后跟您的 tileset 的惟一句柄:username.handle。请注意,在Mapbox Studio 样式编辑器中建立的样式和上载到 Mapbox Studio 或经过 Mapbox Studio 数据集编辑器建立的数据集没有map ID - 它们用 style URLsdataset 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

适用于 AndroidMapbox Maps SDK 是一个开源工具集,用于为 Android 设备构建地图应用程序,具备极大的视觉样式和可定制性灵活性。

Mapbox Maps SDK for iOS

适用于 iOSMapbox Maps SDK 是一个开源工具集,用于为 iPhoneiPad 设备构建地图应用程序,具备极大的视觉样式和可定制性灵活性。

Mapbox Directions API (路线)

借助 Mapbox Directions API,您能够向地图添加带有转弯路线的路线。 Mapbox提供三种不一样的配置文件:驾驶,步行和骑自行车。

有关更多信息和示例,请查看:

Mapbox Editor(一个过时的地图编辑器)

注意:不推荐使用 Mapbox 编辑器。您能够在 这里 找到现有项目。有关更多信息,请参阅咱们的 公告迁移Mapbox编辑器项目指南

Mapbox Editor 是一个用于设计地图的在线界面。 Mapbox 编辑器 再也不处于快速迭代开发阶段。 有关咱们最新的地图设计工具,请查看 Mapbox Studio

Mapbox GL

Mapbox GL 是一套开源库,用于在 Web,移动和桌面应用程序中嵌入高度可定制和响应的客户端映射。地图以超高帧速率渲染。您可使用 Mapbox Studio 中设计的自定义样式。您还能够动态操做样式外观的各个方面,由于 Mapbox GL 渲染矢量切片。缩写 GL 来自 OpenGL ,行业标准的开放图形库。

Mapbox GL 在如下平台上获得官方支持:

若是您但愿将 Mapbox 地图合并到混合 AndroidiOS 应用程序中,请查看咱们关于构建 混合应用程序 的页面。请注意,咱们没法为混合框架提供支持。

Mapbox GL JS

Mapbox GL JS 是一个使用 Mapbox GL 渲染交互式地图的 JavaScript 库。它能够无偿使用。

您能够将 Mapbox Studio 建立的 Mapbox 样式自定义样式 添加到 Mapbox GL JS 应用程序中。

Mapbox.js

Mapbox.js 是一个 JavaScript 库,容许您向网站添加交互式地图。它是 Leaflet 的插件,是一个能够无偿使用的开源库。

您能够将任何 Mapbox Studio styleMapbox Studio Classic style 用做 Mapbox.js 中的底图。有关更多信息,请参阅 Mapbox.js文档

Mapbox Map Matching API

Mapbox Map Matching API 容许您记录记录的迹线,例如 GPS 跟踪器中的数据,并将它们捕捉到 OpenStreetMap 道路和路径网络。这有助于对齐嘈杂的轨迹并在地图上干净地显示它们。

Mapbox Maps SDK for React Native

适用于 React NativeMapbox Maps SDK 是一个跨平台解决方案,提供可重用的 JavaScript 组件,用于构建 AndroidiOS 应用程序中的映射和位置。

Mapbox Maps SDK for Unity

Mapbox Maps SDK for Unity 是一组用于从真实地图数据构建 Unity 应用程序的工具。它包含一个强大的 API,用于链接 Mapbox Web 服务,将地图资源转换为游戏对象,以及构建在 Unity 平台之上的强大的图形用户界面。

要在您的应用程序中包含Mapbox Maps SDK for Unity,请访问文档页面以获取安装说明,API参考和教程:

Mapbox Matrix API (矩阵)

Mapbox Matrix API(之前称为距离 API)计算一个API请求中多个点之间的行程时间。

Matrix API 返回多个位置之间的行程时间,专门用于构建时间表或矩阵。多播源和目标的数量以建立矩阵或时间表,并计算发出请求所需的元素数量。例如,给定3个位置A,B,C,Matrix API 将返回全部位置之间全部行程时间(以秒为单位)的矩阵:

image.png

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个元素)。

演示.gif

阅读有关 Mapbox Matrix API 如何在咱们全面的方向工做指南中工做的 更多信息

Mapbox Navigation SDK (导航)

Mapbox Navigation SDK 构建于 Mapbox Directions API 之上,Mapbox Navigation SDK 包含如下关键功能:

  • 插入式的turn-by-turn导航UI。
  • 汽车,自行车和步行路线。
  • 避免交通堵塞。
  • 机动公告。
  • 文字说明。
  • 文本到语音支持。
  • 自动从新规划路线。
  • 快速路线。

要在应用程序中包含 Mapbox Navigation SDK,请访问相应的文档页面以获取安装说明,API参考和示例代码:

Mapbox Satellite (卫星)

Mapbox Satellite 是高分辨率卫星图像的全球底图。 图像数据来自各类商业提供商,以及来自 NASAUSGS 和其余公司的开放数据。 它通过颜色校订并混合在一块儿成为一个光栅图块集。

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 ClassicMapbox EditorMapbox map ID,请使用Classic Static API

要了解更多信息,请阅读 建立静态地图

Mapbox Studio Classic

Mapbox Studio Classic 是一个用于设计地图的桌面应用程序。 它容许您使用矢量切片和 CartoCSS 建立地图。 Mapbox Studio Classic 容许您以 MBTiles 格式将地图直接导出并上传到 Mapbox 账户,而后与咱们的开发人员工具一块儿使用。

建立新地图?Mapbox StudioMapbox Studio Classic 的现代替代品。 若是您今天开始建立地图,咱们建议您使用 Mapbox Studio 而不是 Mapbox Studio Classic

image.png

Mapbox Studio

Mapbox Studio 是一个用于建立自定义地图的 Web 应用程序。 您能够管理和建立数据集,切片集和地图样式。

要开始使用 Mapbox Studio,请查看 Mapbox Studio手册

Mapbox Uploads API (上传)

使用 Mapbox Uploads API,您能够将 Mapbox 强大的数据上传功能集成到您的应用程序中。 咱们提供临时凭证以在 S3 上暂存空间文件,而后将其处理为 Mapbox GL和Mapbox.js 可读的栅格切片或 Mapbox 矢量切片。

API支持各类空间文件类型,包括GeoJSONKMLGPXShapefilesCSVGeoTIFF, and MBTiles 咱们不断增长对更多类型和更大文件的支持。

Mapbox web services (Mapbox Web服务)

Mapbox Web服务Mapbox 的最低级别接口 - 它们是咱们的 JavaScriptObjective-C 和其余系统构建的 API

您能够从任何语言或环境链接到 Mapbox Web服务 - 您可使用 Python 请求模块,node.js 请求模块,用于 RubyHTTParty 或您选择的语言的其余 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 (月活跃用户)

对于使用适用于 iOSAndroidReact NativeUnityMapbox Maps SDK 构建的本机移动应用程序,咱们会跟踪每个月活跃用户(MAU),也称为移动用户,而不是地图视图。 这是在给定月分内访问应用程序中的地图的用户数。

请参阅咱们的订价页面,了解您的计划包含的移动用户数量。 若是没有符合您需求的计划,请联系咱们的销售团队 以了解有关咱们的自定义计划产品。

对于使用任何其余API构建的地图,咱们会计算 每个月地图视图


O


offline regions and offline packs (离线区域和离线包)

offline regions(也称为适用于 iOSMapbox Maps SDK 中的脱机包)是地图的已定义区域,可用于具备有限网络链接或无网络链接的条件,使用适用于 Mapbox Maps SDK for iOS 和  Mapbox Maps SDK for Android。 有关更多信息,请查看咱们的离线地图指南

OpenStreetMapOSM维基百科

OpenStreetMap 是一个合做项目,以创造一个自由编辑地图的世界,任何人均可以向该地图贡献数据。OpenStreetMap 的数据能够免费共享和使用。Mapbox Streets tileset 源数据源自OpenStreetMap。 为Directions API和相关 API 提供支持的路由网络也基于OpenStreetMap

overzoom

Overzoomtileset 被放大超出其给定缩放范围的结果。

若是出现 Overzoom ,则光栅图块集将显得不清晰。 例如,若是要显示 z0z6 之间缩放范围的光栅图块集,若是缩放到 z6 以后的更高缩放级别,图像将变得模糊且难以看清。

因为矢量数据不是以基于像素的格式存储,而是从一系列点,线和多边形进行编码和计算,所以过分变换的效果对于矢量图块集并不明显。 所以,矢量数据能够被过分显示并可视化以进行缩放22。


P


projection (投影)

projection 是将行星上的位置坐标转换为二维平面的方法。 Mapbox 支持流行的 Web Mercator projectionWeb 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 能够读取 shpshxdbfprjindex 文件。 使用 zip文件上传的任何其余文件都将被忽略。

有关上载shapefile的更多信息,请查看Mapbox Studio手册上传页面 Download a sample shapefile

simplestyle 

Simplestyle 是一种用于样式化 GeoJSON 数据的开源规范。

source layer  (资源图层)

source layer 是矢量资源中的特定图层。 矢量资源能够有多个层。 您能够在如下几个位置找到source layer的名称:

  • 特定 tilesettileset 信息页面。
  • Mapbox Studio 的样式编辑器使用***Select data tab***。
  • Mapbox Studio 样式编辑器中,使用工具栏中的***Style reference***选项。

Tileset 信息页面

要在tileset中查找源图层:

  1. 访问您的Tilesets页面
  2. 单击其中一个tileset的名称。
  3. 将打开tileset信息页面,您能够在Layer details标题下找到源图层。

image.png

在Mapbox Studio样式编辑器中选择data

要查找Mapbox样式中使用的源图层的名称,请执行如下操做:

  1. 在Mapbox Studio样式编辑器中打开样式。
  2. 单击图层列表中图层的名称。
  3. 切换到***Select data***选项卡。
  4. 找到tileset源名称下面列出的源图层。

在下面的示例中,图层名为place-city-label-major,源图层是Mapbox Streets图块集源中的place_label图层。

define-source-layer.gif

Mapbox Studio Style editor中的样式引用

要查找Mapbox样式中使用的源图层的名称,请执行如下操做:

  1. 在Mapbox Studio样式编辑器中打开样式。
  2. 单击右上方工具栏中的样式参考选项。

在下面的示例中,源图层称为waterway_label,该图层称为waterway-label。

toolbar-style-reference-source-layer.png

source  (数据源)

source 提供要在Mapbox GL的地图上显示的数据。 sourceMapbox 样式规范定义,并与样式层一块儿使用,以直观地表示地图上的source数据。 根据您正在开发的平台,可能不支持特定的source类型,所以在向地图添加source时请参阅特定于平台的文档

sprite

sprite 是包含样式中包含的全部图标的单个图像。 sprite一般用于网络开发甚至视频游戏,以提升性能。 经过将大量小图像组合成单个图像(sprite),您能够减小获取全部图像所需的请求数量,从而提升性能并使地图更快。

若是您使用的是 Mapbox Studio,则无需担忧sprite的技术基础:上传 SVG 图标会自动建立地图将使用的sprite。 一样,全部 Mapbox 模板样式都带有本身的sprite,其中包含能够与该样式一块儿使用的图标。 调试面板中的**Images选项显示sprite中使用的像素数量。

spritesheet-usage.png

若是您想本身动手或者对引擎盖下的内容感兴趣,您也能够建立本身的sprite。 这是全部术语和sprite如何工做的概述。

sprite将许多图标组合成一个图像:

sprite.png

图标是sprite中的单个图像:

airport-15.png

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 地图中,加载的图块包括全部四个图层,即便它们并不是所有都须要。 风格优化的矢量瓷砖仅包括露营地,林地和蓝山。 它会根据属性和缩放级别删除未使用的图层和要素。

style-optimized-illustration.png

您能够在 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 URLstyle URL容许您使用 Mapbox GL JS API 或本机 SDK 引用该特定样式。

您能够在 Mapbox StudioStyles page 上找到样式 URL。 单击样式旁边的 Menu 按钮以显示其样式 URL 。 单击图标以复制样式URL

style-url.gif

style  (样式)

style 是定义地图视觉外观的文档。 样式使用 Mapbox Studio 样式编辑器建立或单独编写并上载到您的账户。 它们遵循 Mapbox 样式规范,并包含有关数据源,样式图层,精灵(sprite),字形和元数据的信息。 styleMapbox GL JS,适用于 Mapbox Maps SDK for Android ,适用于 Mapbox Maps SDK for iOSMapbox Static API

有关样式的更多信息,请查看 Mapbox Studio手册

SVG (可缩放矢量图形)

SVG 是一种用于描述二维矢量图形的标记语言。

您能够在 Mapbox Studio 样式编辑器中将SVG图像上载到自定义样式。 您能够单击调试面板中的 Images 选项来管理您的样式中的SVG

manage-style-images.png

请参阅如下指南以开始使用:

 Download sample SVG image


T


telemetry  (测量)

telemetry 是一个过程,其中自动传感器经过收集关于人们移动的位置和方式的匿名数据来建立和更新地图。 这对于发现丢失的道路,跟踪交通讯息等很是有用。

TIFF  (文件格式)

TIFF(有时是TIF)是用于保存光栅图像的文件格式。 使用 MapboxTIFF一般是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个预设缩放级别的均匀方块网格。 tilesetMapbox 库和 SDK 中用做在移动设备或浏览器中显示地图的核心部分。 它们也是咱们用于肯定地图视图的主要机制。

tileset可高度缓存并快速加载。 Mapbox 在很大程度上依赖于栅格和矢量tileset来保持咱们的地图快速高效。 有关使用tileset的更多信息,请查看Mapbox Studio手册

Tilesets能够是RasterVector。 差别概述以下:

Raster tilesets (栅格)

将光栅图像做为 TIFF / GeoTIFF上传到 Mapbox Studio 时会建立光栅图块集。 它们在现代和经典 Mapbox 工具中使用,将地图显示为可在必要时在地图上加载的图像网格。 您能够在Mapbox StudioMapbox GL JS, 和 Mapbox Mobile SDKs 中使用Raster tilesets

传统的Web地图库(如 Mapbox.jsLeaflet )也使用栅格切片在网页上显示地图。 Mapbox Studio Classic 中建立的全部经典样式也包含Raster tilesets

Vector tilesets (矢量)

Vector tilesets 是栅格tilesets的矢量数据 - 不是以像素的形式存储栅格数据,Vector tilesets 以点,线和多边形的形式存储矢量数据做为矢量tile。 Vector tilesets能够被操纵和查询。 它们能够用做样式的来源或直接查询以使用 Mapbox Mobile SDKsMapbox GL JS 建立交互式体验。

将矢量数据(GeoJSONShapefileKML, 或 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来查看 tilesetzoom extent

Mapbox Studio 中建立切片集时,会指定缩放范围以限制其可见性并确保地图数据有效呈现。 经过仅在某些缩放级别渲染 tileset ,较低分辨率的数据将不会出如今较高的缩放级别,而且详细数据不会以较低的缩放级别混乱地图。 若是要更改 tileset 的缩放范围,可使用 其余Mapbox工具

zoom level (缩放级别)

zoom level 决定了地图的可见程度:在缩放级别0,您能够看到整个世界,在缩放级别16,您能够看到一条小路。 该数据存储在 quadtree 数据结构中。 缩放级别还会影响加载的矢量切片的大小。



到此Mapbox词汇表相关的术翻译完成,欢迎 👏 指正。

相关文章
相关标签/搜索