はじめに
Google Maps Platform の Directions API を使うための準備について投稿します。初期設定～ブラウザでのテストまでを記載しています。
2022年6月時点の情報になります。
Google Maps Platform とは
GoogleマップのAPI群です。カスタマイズしたマップの埋め込みや距離の取得など、Googleマップの情報を様々に応用できるサービスです。
料金
1つのアカウントにつき、月$200までは無料で利用できます。その上限を超えると、使った分だけ料金が請求されます。
セットアップ方法
流れは以下の通りです。
- Google Cloud Platformへのログイン
- プロジェクトの作成
- 請求先アカウントの作成
- APIキーの発行
公式スタートガイドはこちらです。
Google Cloud Platform へのログイン
以下にアクセスします。
「使ってみる」をクリック。
Googleアカウントでログイン。もしアカウントがなければ新規作成します。
利用規約に同意します。
プロジェクトの作成
最初は「My First Project」というプロジェクトが自動で作成されます。プロジェクト単位でAPIを管理することができ、新たに作ることもできます。ここでは「My First Project」を使用していきます。
請求先アカウントの作成（課金の有効化）
最初は無料トライアルを始める、という形になります。
無料トライアルを含め、APIを利用するためには請求先を登録する必要がありますが、この時点ですぐに課金されることはありません。
「請求先アカウントを作成」をクリックします。
1/3 画面の指示に従って進みます。
2/3
3/3 最後に支払い情報を登録します。カード情報を入力すると住所入力欄も表示されます。
APIキーの発行
続いて実際にAPIを使えるようにしていきます。初回に画像のポップアップが出ると思います。黒く塗ってある部分がAPIキー（後述）です。
「デモを作成」をクリックして先に進みます。
APIキーの保護（後述）はいったん「後で」をクリックします。
以下のメッセージが出れば準備完了です。
とりあえずテストしてみたい場合は、こちらの項目に飛んでください。
APIキーとは
APIを利用するアカウントを識別する一意の文字列です。APIを呼び出す際のリクエストにこのキーを必ず含める必要があり、これをもとに使用量が集計され課金されます。単なる文字列のため呼び出し元等を制限しないと、第三者からの不正利用を許してしまいます。そのため、上記でAPIキーの保護を推奨するポップアップがありました。
APIキーの保護① アプリケーションの制限
試しに呼び出し元を自分のIPアドレスで制限してみましょう。制限することで、そのIPアドレスからしかAPIを呼び出せなくなります。
IPアドレスでの制限は、IPアドレスが変わる度に以下の設定が必要になります
コンソールの「認証情報」をクリックすると発行されたAPIキーが確認できます。右側の鉛筆マークをクリックします。
以下の編集画面に移動したら、「アプリケーションの制限」で「IPアドレス」を選びます。
「項目を追加」をクリックします。
自分のIPアドレスを入力して「完了」をクリックします。IPアドレスはこちらのようなサービスで調べられます。
以上でIPアドレスによる制限は完了です。
APIキーの保護② APIの制限
APIキーで呼び出せるAPIを限定しておく設定です。Directions API のみを呼び出せるようにしてみます。
先ほどのIPアドレスの入力欄の下に「APIの制限」がありますので、「キーを制限」をクリックします。
その下のプルダウンメニューで「Directions API」にチェックを付け、「OK」をクリックします。
以下の表示になったら、「保存」をクリックして完了です。
詳細
APIキーの保護については、以下でより詳しく解説されています。
使用量の制限
誤って大量のリクエストをして多額の料金が請求されないように、APIの使用量（リクエスト数）の上限を設定しておきます。
Directions API を無料枠\$200内で済ませる場合、リクエスト1,000回あたり$5（料金表）なので、1日あたりのリクエスト上限は1,290回（=40,000÷31）になります。
設定は「割り当て」タブから行います。
「Requests」を展開し、「Requests /日」の鉛筆マークをクリックします。
割り当て上限の「無制限」からチェックを外し、上限値を入力します。もし画面のような注意書きが出たら、「確認」にチェックを入れて保存します。
以上で使用量の制限がかかりました。
テスト
準備が完了しましたので、いよいよブラウザでテストしてみます。
リクエスト形式
形式は次の通りです。
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
ベースのURLはhttps://maps.googleapis.com/maps/api/directions/で、結果の受け取り方（json/xml）をoutputFomatで指定します。parameters部分がリクエストパラメータ（具体的な要求内容）です。
必須パラメータは以下3点です。
| パラメータ名 | 内容 |
|---|---|
| origin | 出発地 |
| destination | 目的地 |
| key | APIキー |
他にもたくさんのパラメータがあります。公式ドキュメントはこちらです。
テスト実行
試しに札幌駅から新千歳空港までの自動車走行距離をJSONで取得してみましょう。
メモ帳などのテキストエディタを開き、次のURLをコピペします。
https://maps.googleapis.com/maps/api/directions/json?origin=札幌駅&destination=新千歳空港&key=YOUR_API_KEY
最後の YOUR_API_KEY を自身のAPIキーに置き換えてください。置き換えたら、ブラウザの検索窓にコピペしてEnterしてみます。以下のような長いJSONがブラウザに表示され、最後のstatusがOKならテストは成功です！
{
"geocoded_waypoints": [
{
"geocoder_status": "OK",
"place_id": "ChIJA_nD0nQpC18RpUdK3Yyx4qU",
"types": [
"establishment",
"point_of_interest",
"train_station",
"transit_station"
]
},
{
"geocoder_status": "OK",
"place_id": "ChIJ3RpcnUUgdV8R9oH25Xxguho",
"types": [
...（略）...
],
"status": "OK"
}