前言

Mapbox詞彙表英文文件

本文詞彙表按照字母順序排序

---

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手冊。

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 編輯器會為您生成嵌入程式碼，以便將地圖新增到您的網站或部落格中。嵌入程式碼使用 <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 的基礎。它是在網頁上執行的軟體，可以使互動式地圖成為可能。 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中查詢源圖層：

1. 訪問您的Tilesets頁面。
2. 單擊其中一個tileset的名稱。
3. 將開啟tileset資訊頁面，您可以在Layer details標題下找到源圖層。

在Mapbox Studio樣式編輯器中選擇data

要查詢Mapbox樣式中使用的源圖層的名稱，請執行以下操作：

1. 在Mapbox Studio樣式編輯器中開啟樣式。
2. 單擊圖層列表中圖層的名稱。
3. 切換到***Select data***選項卡。
4. 找到tileset源名稱下面列出的源圖層。

在下面的示例中，圖層名為place-city-label-major，源圖層是Mapbox Streets圖塊集源中的place_label圖層。

Mapbox Studio Style editor中的樣式引用

要查詢Mapbox樣式中使用的源圖層的名稱，請執行以下操作：

1. 在Mapbox Studio樣式編輯器中開啟樣式。
2. 單擊右上方工具欄中的樣式參考選項。

在下面的示例中，源圖層稱為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詞彙表相關的術翻譯完成，歡迎 ? 指正。