Maps SDK for Unity

Current version: v2.1.1View changelog

Vector map of the world（世界矢量地图）

Cloudless satellite base map（万里无云卫星底图）

Global digital elevation model（全球数字高程模型）

Custom data（自定义数据）

The Mapbox Maps SDK for Unity is a collection of tools for building Unity applications from real map data. It enables Unity developers to interact with Mapbox web services APIs (including the Maps, Geocoding and Directions APIs) and create game objects via a C#-based API and graphical user interface.

Mapbox Maps SDK for Unity 是一组用于从真实地图数据构建 Unity 应用程序的工具。 它使 Unity 开发人员能够与 Mapbox 网络服务 API（包括地图、地理编码和方向 API）交互，并通过基于 C# 的 API 和图形用户界面创建游戏对象。

Getting started（入门）

Install the Maps SDK for Unity（安装适用于 Unity 的 Maps SDK）

To install the Maps SDK for Unity, follow the instructions in the installation guide. Once installed, you can start exploring some of the examples in the SDK. Also, you can read the Help section for tutorials, troubleshooting guides, and other resources to get you started. If you're interested in working with the API, you can find the documentation in the API reference section.

要安装 Maps SDK for Unity，请按照安装指南中的说明进行操作。 安装后，您可以开始探索 SDK 中的一些示例。 此外，您还可以阅读“帮助”部分以获取教程、故障排除指南和其他资源以帮助您入门。 如果您对使用 API 感兴趣，可以在 API 参考部分找到相关文档。

Example scenes（示例场景）

The Maps SDK for Unity comes with several example scenes to showcase various features and possibilities of the SDK. You can find these scenes by navigating to Mapbox > Setup, or by looking at the Examples folder in the Project window and double-clicking on a Scene file to open it.

Maps SDK for Unity 附带了几个示例场景来展示 SDK 的各种功能和可能性。 您可以通过导航到 Mapbox > Setup 找到这些场景，或者通过查看项目窗口中的 Examples 文件夹并双击场景文件将其打开。

Editor preview（编辑预览）

Each node is a ScriptableObject in the mesh generation structure, and corresponds directly to a file in the project. Click on a node to see its settings in the Inspector panel.

每个节点都是网格生成结构中的一个ScriptableObject，直接对应工程中的一个文件。 单击一个节点可在检查器面板中查看其设置。

While you build your map you’ll see the Enable Preview button on the AbstractMap.cs script. Clicking this button displays the map with all current settings.

在构建地图时，您会在 AbstractMap.cs 脚本上看到启用预览按钮。 单击此按钮将显示具有所有当前设置的地图。

Map editor（地图编辑器）

The map editor is a modular, tree-like node editor designed to help developers create their custom map visualizations. It can be found under Mapbox > Map Editor in the Unity top bar. While it is not necessary to use, it is a valuable tool for navigating and understanding the underlying structure of a map.

地图编辑器是一个模块化的树状节点编辑器，旨在帮助开发人员创建他们的自定义地图可视化效果。 它可以在 Unity 顶部栏中的 Mapbox > Map Editor 下找到。 虽然它不是必须使用的，但它是导航和理解地图底层结构的宝贵工具。

Each node is a ScriptableObject in the mesh generation structure, and corresponds directly to a file in the project. Click on a node to see its settings in the Inspector panel.

每个节点都是网格生成结构中的一个ScriptableObject，直接对应工程中的一个文件。 单击一个节点可在检查器面板中查看其设置。

The Map Editor also includes checkboxes next to the vector factory's layer visualizers, which allows you to toggle the layers on and off. This allows for quick customizations of which style layers to show.

地图编辑器还包括矢量工厂图层可视化器旁边的复选框，允许您打开和关闭图层。 这允许快速自定义要显示的样式层。