Route A Phase 3 : Implementation

A-05：コア機能の実装

Google Maps API連携 - ツールに「目」を与える

Lesson A-04の「創成の呪文」で、ツールの大枠はすでに出来上がっているはずです。
しかし、Googleマップと通信するための「パスワード（APIキー）」が設定されていないため、まだ検索や距離計算は動きません。

このレッスンでは、Google Cloudでキーを取得し、AIが生成したコードが正しく最新のAPIを使っているか「点検・修正」を行います。

1. 【重要】Google Cloudでの準備

Googleマップのデータを利用するには、GCPで機能を有効化し、APIキーを取得する必要があります。

Step 1: プロジェクト作成とAPI有効化

Google Cloud Console にアクセスし、ログインします。
画面上部のプロジェクト選択プルダウンから「新しいプロジェクト」を作成します。
左メニューの「APIとサービス」>「ライブラリ」を開きます。
以下の3つのAPIを検索し、それぞれ「有効にする」ボタンを押してください。
- Places API (New) (店舗リスト作成用)
- Geocoding API (住所から座標への変換用)
- Routes API (2点間の距離計算用)

Step 2: APIキーの取得

左メニューの「APIとサービス」>「認証情報」を開きます。
上部の「認証情報を作成」>「APIキー」を選択します。
表示されたキー（AI...で始まる文字列）をコピーしてください。

⚠️ 料金について（2025年最新）

APIを利用するにはクレジットカード登録が必須です。ただし、個人利用レベル（月間数千回程度）であれば、毎月の無料枠内に収まるケースがほとんどです。

2. 設定とコードの監査（進化の呪文）

APIキーを取得したら、まず手動で設定ファイルに書き込みます。

設定手順：
プロジェクト内の system/config.py を開き、GOOGLE_MAPS_API_KEY = "..." の部分に、取得したキーを貼り付けて保存してください。
※注意：api_key.txt はGemini用なので、こちらには貼らないでください。

次に、Lesson A-04でAIが作ったコードが、「本当に最新のAPIを正しく使い分けているか？」をチェックさせます。
AIは時々、古い廃止されたAPI（Distance Matrixなど）を使ってしまう癖があるため、ここで矯正します。

🔧 API最適化プロンプト

あなたはプロのPython開発者です。

現在、Googleマップ自動化ツールの初期コード（Lesson 04で生成）があります。

これに対し、Google Maps Platformとの連携設定とコードの最適化を行ってください。



【確認・修正依頼】

1. API設定: `system/config.py` に `GOOGLE_MAPS_API_KEY` という設定項目を追加（または確認）し、そこからキーを読み込むようにしてください。（ソースへの直書きは禁止）



2. APIの最新化と役割分担（最重要）: ツール内の機能に応じて、以下の3つのAPIを正しく使い分けるようにコードを監査・修正してください。

   - **店舗検索**: `Places API (New)` を使用すること。

   - **住所→座標変換**: `Geocoding API` を使用すること。（基準住所の特定や、CSV内の住所から座標を取得する際に必須です）

   - **距離計算**: `Routes API (Compute Routes)` を使用すること。（旧来のDistance Matrix APIは新規プロジェクトで使用不可のため、絶対に使用しないこと）



3. エラーハンドリング: APIキーが無効、またはクォータ切れ(REQUEST_DENIEDなど)の場合に、GUIのログエリアに分かりやすく「GoogleマップAPIエラー」と表示し、原因究明のヒント（APIが有効か、請求先設定は正しいか等）も追記するよう修正してください。



【出力ルール】

修正が必要なファイル名と、その修正後のコード全文を提示してください。

既存のコードを壊さないよう注意してください。

ファイルマーカーの出力は禁止。ファイル名だけをコードブロックの外に表示し、ファイルは省略禁止でお願いします。

A-06 (データ連携) へ進む ← Route A トップへ戻る