必要條件

在開始設計第一個用戶端應用程式之前,您必須先做以下幾件事。

建立 Google 帳戶

您必須擁有 Google 帳戶,才能在 Google API 控制台中建立專案。如果您已經有帳戶,則您已準備好了。

您可能也想要另外有個測試用的 Google 帳戶。

試用 Google 街景服務

本 API 說明文件假設您已採用 Google 街景服務,且您已熟悉網路程式設計概念和網路資料格式。

如果您還沒使用 Google 街景服務,請先體驗使用者介面,再開始撰寫程式碼。

為用戶端建立專案

您必須先向 Google 告知用戶端並啟用 API 的存取權,才能傳送要求給 Google 街景服務。只要使用 Google API 控制台來建立「專案」 (內含已命名的設定和 API 存取權資訊),並註冊應用程式即可。

如要開始使用 Google Street View Publish API,您必須先使用設定工具,讓系統引導您在 Google API 控制台中建立專案、啟用 API,以及建立憑證。

如果您尚未完成,請按一下「Create credentials > API key」(建立憑證 & API) 金鑰,建立應用程式的 API 金鑰。接著,在「API 金鑰」部分尋找 API 金鑰。

瞭解 REST 的基本概念

您可以透過下列 2 種方式叫用 API:

如果您決定不使用用戶端程式庫,則必須瞭解 REST 的基本概念。

REST 是一種軟體架構,可提供簡便且一致的資料要求及修改方法。

REST 為 Representational State Transfer (具象狀態傳輸) 的簡稱。在 Google 的 API 中,這是指使用 HTTP 動詞來擷取及修改 Google 儲存的資料表示法。

在符合 REST 樣式的系統中,資源會儲存在資料儲存庫中。用戶端向伺服器發出執行特定動作 (例如建立、擷取、更新或刪除資源) 的要求後,伺服器就會執行指定動作並傳回回應 (大多採用指定資源表示法的形式)。

在 Google 的 RESTful API 中,用戶端會使用 HTTP 動詞指定動作,例如 POSTGETPUTDELETE。並由下列格式的全域不重複 URI 指定資源:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

由於所有 API 資源都有可供 HTTP 存取的專屬 URI,因此 REST 不僅能夠支援資料快取,也非常適合與網路的分散式基礎架構搭配運作。

HTTP 1.1 標準說明文件中的方法定義可能非常實用,其中包含 GETPOSTPUTDELETE 的規格。

Google Street View Publish API 中的 REST

Google Street View Publish API 作業直接對應至 REST HTTP 動詞。

Google Street View Publish API URI 的專屬格式如下:

https://www.googleapis.com/streetviewpublish/v1/resourcePath?parameters

關於 API 中各項支援作業的完整 URI 組合,請參閱 Google Street View Publish API 參考資料文件。

瞭解 JSON 的基本概念

Google Street View Publish API 會傳回 JSON 格式的資料。

JSON (JavaScript 物件標記法) 是一種常見的語言獨立資料格式,可透過簡單的文字顯示任意資料結構。詳情請參閱 json.org