前提条件

最初のクライアント アプリケーションのコーディングを開始する前に、行うことがいくつかあります。

Google アカウントを取得する

Google API Console でプロジェクトを作成するには、Google アカウントが必要です。すでにアカウントをお持ちの場合は、準備が整っています。

テスト用に別の Google アカウントを取得することもできます。

Google ストリートビューを試す

この API ドキュメントは、Google ストリートビューを使用していて、ウェブ プログラミングのコンセプトとウェブデータ形式に精通していることを前提としています。

Google ストリートビューをまだ使用していない場合は、コーディングを開始する前にユーザー インターフェースをお試しください。

クライアントのプロジェクトを作成する

Google ストリートビューにリクエストを送信するには、クライアントに関する情報を Google に提供し、API へのアクセスを有効にする必要があります。これを行うには、Google API Console を使用してプロジェクト（設定と API アクセス情報の名前付きコレクション）を作成し、アプリケーションを登録します。

Google Street View Publish API を使用するには、まず設定ツールを使用して Google API Console でプロジェクトを作成し、API を有効にして、認証情報を作成する必要があります。

まだの場合は、[認証情報を作成] > [API キー] をクリックしてアプリケーションの API キーを作成します。次に、[API キー] セクションで API キーを探します。

REST の基礎を学習する

API は次の 2 つの方法で呼び出すことができます。

クライアント ライブラリを使用しない場合は、REST の基礎を理解する必要があります。

REST は、データをリクエストして変更するための便利で一貫したアプローチを提供するソフトウェア アーキテクチャのスタイルです。

REST という用語は「Representational State Transfer」の省略形です。Google API のコンテキストでは、HTTP 動詞を使用して、Google が保存しているデータ表現を取得および変更することを表しています。

RESTful システムでは、リソースはデータストアに保存されており、クライアントはサーバーが特定のアクション（リソースの作成、取得、更新、削除など）を実行するようにリクエストを送信します。サーバーはそのアクションを実行し、多くの場合、指定されたリソースの表現形式でレスポンスを送信します。

Google の RESTful API では、クライアントは POST、GET、PUT、DELETE などの HTTP 動詞を使用してアクションを指定します。グローバルに一意の URI でリソースを指定して、次の形式にします。

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

すべての API リソースは HTTP でアクセス可能な一意の URI を持っているため、REST はデータ キャッシュを有効にし、ウェブの分散インフラストラクチャで動作するように最適化されています。

HTTP 1.1 標準のドキュメントのメソッド定義をご覧ください。GET、POST、PUT、DELETE の仕様が記載されています。

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 Object Notation）は言語に依存しない一般的なデータ フォーマットであり、任意のデータ構造を単純なテキスト形式で表示します。詳しくは json.org をご覧ください。