一文读懂Unity3D如何加载大地图

如何将大地图集成到 Unity3D 项目中

Cesium 是一款功能强大的地球可视化平台和工具链，可用于创建令人惊叹的三维地球可视化效果。它提供了一个全面的框架，支持各种平台，包括 Unity3D。借助 Cesium，您可以轻松地将大地图集成到 Unity3D 项目中，并创建引人入胜的交互式体验。

安装 CesiumUnity 插件

第一步是下载并安装 CesiumUnity 插件。这个插件充当 Cesium 和 Unity3D 之间的桥梁，使您能够无缝地将 Cesium 功能集成到项目中。转到 Cesium 官方网站，在 Unity 选项卡下下载最新版本的插件。安装插件后，将其导入到您的 Unity3D 项目中。

创建一个 Cesium 地图组件

导入插件后，您需要在 Unity3D 场景中创建一个空的 GameObject，并将其命名为“CesiumMap”。然后，通过单击“添加组件”按钮并选择“Cesium”下的“CesiumMap”组件，将 Cesium 地图组件添加到 GameObject。

设置地图 URL

下一步是设置地图的 URL。Cesium 提供了示例地图 URL，您也可以使用自己的地图 URL。如果您使用的是 Cesium 提供的示例地图，可以使用以下代码设置 URL：

using Cesium.Unity;
using UnityEngine;

public class CesiumMapScript : MonoBehaviour
{
    private CesiumMap _cesiumMap;

    void Start()
    {
        _cesiumMap = GetComponent<CesiumMap>();
        _cesiumMap.Url = "https://cesium.com/assets/14819/imagery/naturalearthii/naturalearthii.json";
    }
}

如果您使用的是自己的地图 URL，则可以使用以下代码设置 URL：

using Cesium.Unity;
using UnityEngine;

public class CesiumMapScript : MonoBehaviour
{
    private CesiumMap _cesiumMap;

    void Start()
    {
        _cesiumMap = GetComponent<CesiumMap>();
        _cesiumMap.Url = "file:///Users/USERNAME/Desktop/mymap.json";
    }
}

加载地图

设置地图 URL 后，即可加载地图。您可以使用以下代码加载地图：

using Cesium.Unity;
using UnityEngine;

public class CesiumMapScript : MonoBehaviour
{
    private CesiumMap _cesiumMap;

    void Start()
    {
        _cesiumMap = GetComponent<CesiumMap>();
        _cesiumMap.Url = "https://cesium.com/assets/14819/imagery/naturalearthii/naturalearthii.json";
        _cesiumMap.Load();
    }
}

三维可视化

加载地图后，您可以使用 Cesium 进行三维可视化。以下代码示例演示了如何将 3D 模型添加到地图：

using Cesium.Unity;
using UnityEngine;

public class CesiumMapScript : MonoBehaviour
{
    private CesiumMap _cesiumMap;

    void Start()
    {
        _cesiumMap = GetComponent<CesiumMap>();
        _cesiumMap.Url = "https://cesium.com/assets/14819/imagery/naturalearthii/naturalearthii.json";
        _cesiumMap.Load();

        // 添加一个实体到地图上
        Cesium3DModel entity = _cesiumMap.AddEntity();
        entity.Model = new Cesium3DModel();
        entity.Model.Uri = "file:///Users/USERNAME/Desktop/model.glb";
        entity.Position = new Cartesian3(-75.59777, 40.03883, 0);
        entity.Scale = new Cartesian3(1, 1, 1);
    }
}

常见问题解答

• 如何更新地图？

using Cesium.Unity;
using UnityEngine;

public class CesiumMapScript : MonoBehaviour
{
    private CesiumMap _cesiumMap;

    void Start()
    {
        _cesiumMap = GetComponent<CesiumMap>();
        _cesiumMap.Url = "https://cesium.com/assets/14819/imagery/naturalearthii/naturalearthii.json";
        _cesiumMap.Load();
    }

    void Update()
    {
        // 更新地图
        _cesiumMap.Update();
    }
}

• 如何在地图上放置标记？

using Cesium.Unity;
using UnityEngine;

public class CesiumMapScript : MonoBehaviour
{
    private CesiumMap _cesiumMap;

    void Start()
    {
        _cesiumMap = GetComponent<CesiumMap>();
        _cesiumMap.Url = "https://cesium.com/assets/14819/imagery/naturalearthii/naturalearthii.json";
        _cesiumMap.Load();

        // 添加一个点实体到地图上
        CesiumPointGraphics entity = _cesiumMap.AddEntity();
        entity.Point = new CesiumPointGraphics();
        entity.Point.Color = new Cartesian4(1, 0, 0, 1);
        entity.Point.Show = true;
        entity.Position = new Cartesian3(-75.59777, 40.03883, 0);
    }
}

• 如何在地图上绘制线？

using Cesium.Unity;
using UnityEngine;

public class CesiumMapScript : MonoBehaviour
{
    private CesiumMap _cesiumMap;

    void Start()
    {
        _cesiumMap = GetComponent<CesiumMap>();
        _cesiumMap.Url = "https://cesium.com/assets/14819/imagery/naturalearthii/naturalearthii.json";
        _cesiumMap.Load();

        // 添加一条线实体到地图上
        CesiumPolylineGraphics entity = _cesiumMap.AddEntity();
        entity.Polyline = new CesiumPolylineGraphics();
        entity.Polyline.Color = new Cartesian4(1, 0, 0, 1);
        entity.Polyline.Width = 5;
        entity.Polyline.Positions = new Cartesian3[]
        {
            new Cartesian3(-75.59777, 40.03883, 0),
            new Cartesian3(-74.59777, 40.03883, 0)
        };
    }
}

• 如何在地图上绘制多边形？

using Cesium.Unity;
using UnityEngine;

public class CesiumMapScript : MonoBehaviour
{
    private CesiumMap _cesiumMap;

    void Start()
    {
        _cesiumMap = GetComponent<CesiumMap>();
        _cesiumMap.Url = "https://cesium.com/assets/14819/imagery/naturalearthii/naturalearthii.json";
        _cesiumMap.Load();

        // 添加一个多边形实体到地图上
        CesiumPolygonGraphics entity = _cesiumMap.AddEntity();
        entity.Polygon = new CesiumPolygonGraphics();
        entity.Polygon.Color = new Cartesian4(1, 0, 0, 1);
        entity.Polygon.Positions = new Cartesian3[]
        {
            new Cartesian3(-75.59777, 40.03883, 0),
            new Cartesian3(-74.59777, 40.03883, 0),
            new Cartesian3(-74.59777, 39.03883, 0),
            new Cartesian3(-75.59777, 39.03883, 0)
        };
    }
}

• 如何在地图上添加文本标签？

using Cesium.Unity;
using UnityEngine;

public class CesiumMapScript : MonoBehaviour
{
    private CesiumMap _cesiumMap;

    void Start()
    {
        _cesiumMap = GetComponent<CesiumMap>();
        _cesiumMap.Url = "https://cesium.com/assets/14819/imagery/naturalearthii/naturalearthii.json";
        _cesiumMap.Load();

        // 添加一个文本标签实体到地图上
        CesiumLabelGraphics entity = _cesiumMap.AddEntity();
        entity.Label = new CesiumLabelGraphics();
        entity.Label.Text = "Hello Cesium";
        entity.Label.Color = new Cartesian4(1, 0, 0, 1);
        entity.Label.ShowBackground = true;
        entity.Position = new Cartesian3(-75.5977