注意:Google 地圖平台遊戲服務已於 2021 年 10 月 18 日淘汰。2022 年 12 月 31 日過後,現有使用者仍可繼續使用。在此期間,我們會持續提供重大錯誤和服務中斷問題的相關支援和修正。請參閱遊戲服務轉換指南,瞭解如何妥善規劃專案的後續步驟。

語意圖塊通訊協定和範例伺服器

Unity SDK 會使用 semantictileapi.proto 中的通訊協定緩衝區介面擷取地圖項目和地形圖塊資源。替換服務應實作這個 API。提供 Python 伺服器範例,以示範 SDK 傳遞參數的方式,以及該如何建立回應以與 SDK 相容。

下載封存檔

封存包含下列檔案:

  • semantictileapi.proto 是 Unity SDK 使用的通訊協定緩衝區定義,用於擷取地圖項目和地形圖塊資源。

  • server.py 是一個範例伺服器,展示與 SDK 相容的通訊協定緩衝區序列化及提供功能。

  • BUILD.bazelWORKSPACE.bazel 構成的 Bazel 專案,可用來產生 Python 的通訊協定緩衝區繫結。如要進一步瞭解如何安裝及使用 Bazel,請參閱 https://bazel.build/

  • example_tiles.py 示範如何使用 Python 建立 FeatureTilesTerrainTiles

如何執行

安裝 Bazel 後,執行下列指令即可建構並啟動伺服器:

> bazel run server

如果您不想安裝 Bazel,也可以使用 Protoc 建構 Python 通訊協定緩衝區程式庫。如需 protoc 工具的使用範例,請參閱通訊協定緩衝區基本概念:Python

您可以透過 cURL 將要求傳送至執行中的伺服器:

> curl 'localhost:8000/featuretiles/@120588,78656,17z?alt=proto' --output test_feature
> curl 'localhost:8000/terraintiles/@120588,78656,17z?alt=proto' --output test_terrain

如要查看人類可讀的格式,請使用 alt=json

> curl 'localhost:8000/featuretiles/@120588,78656,17z?alt=json'

如要進一步瞭解地圖項目和地形圖塊格式,請參閱 semantictileapi.proto 的註解。