Apidog

オールインワン協働API開発プラットフォーム

API設計

APIドキュメント

APIデバッグ

APIモック

API自動テスト

GoogleマップMCPサーバーの使い方

中村 拓也

中村 拓也

Updated on 4月 8, 2025

モデルコンテキストプロトコル(MCP)サーバーは、AIアシスタントと専門的な知識ソースを橋渡しし、構造化されたAPI情報などにアクセスできるようにします。この技術は、AIツールに仕様、ドキュメント、機能への直接アクセスを提供することで、開発を変革します。

Google Maps MCPサーバーは、AIアシスタントをGoogleの位置情報サービスに接続し、複雑なマッピングAPIとの自然言語インタラクションを可能にします。Apidog MCPサーバーと組み合わせることで、開発者は、位置サービスとカスタムAPIの両方を活用した洗練されたアプリケーションを構築するための包括的な環境を得ることができます。

Google Maps MCPサーバーの機能を探る

Google Maps MCPサーバーは、AIアシスタントがGoogleの位置情報サービスと直接対話するための専門的なツールを提供します。この強力な統合により、開発者は自然言語の指示を通じてGoogle Mapsの操作を実行できるようになります。

Google Maps MCPサーバーの主な機能

Google Maps MCPサーバーは、7つの主要なツールを提供します:

ジオコーディングmaps_geocode):住所を地理座標に変換し、位置データ、フォーマット済みの住所、場所IDを返します。

逆ジオコーディングmaps_reverse_geocode):座標を住所に変換し、フォーマット済みの住所、場所ID、住所コンポーネントを提供します。

プレイス検索maps_search_places):テキストクエリを使用して場所を検索し、オプションの位置および半径パラメータを指定できます。

プレイス詳細maps_place_details):特定の場所に関する包括的な情報を取得し、連絡先の詳細、評価、営業時間を含みます。

距離マトリックスmaps_distance_matrix):複数の出発地と目的地の間の距離と移動時間を計算します。

標高データmaps_elevation):特定の地理座標に関する標高情報にアクセスします。

経路案内maps_directions):ポイント間の詳細なルート情報を取得し、段階的なナビゲーション指示を含みます。

Google Maps MCPサーバーの設定:ステップバイステップガイド

Google Maps MCPサーバーの実装には最小限の構成が必要ですが、Google Maps APIキーが必要です。

前提条件

  • Node.js(バージョン14以上)
  • Google Maps APIキー
  • モデルコンテキストプロトコルをサポートするAIツール(Cursor、Claude Desktopなど)

Google Maps APIキーの取得

MCPサーバーを設定する前に、Google Maps APIキーを取得する必要があります:

  1. Google Cloud Consoleにアクセスします。
  2. Google Maps Platform > 認証情報ページに移動します。
  3. 「認証情報を作成」をクリックし、「APIキー」を選択します。「作成したAPIキー」ダイアログが新しく作成されたAPIキーを表示します。
  4. 閉じるをクリックします。新しいAPIキーは、認証情報ページのAPIキーの下にリストされます。
  5. プロジェクトに必要なGoogle Maps APIを有効にします。

インストール手順

Google Maps MCPサーバーは、NPXを使って設定できます:

1. MCPクライアントを次のJSONで構成します:

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

<YOUR_API_KEY>を実際のGoogle Maps APIキーに置き換えます。

2. Windowsユーザーの場合、構成をcmdを使用するように修正します:

{
  "mcpServers": {
    "google-maps": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@modelcontextprotocol/server-google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

MCPクライアントを再起動して、変更を適用します。

接続をテストするために、AIアシスタントにGoogle Maps操作を実行させます:

"住所「1600 Amphitheatre Parkway, Mountain View, CA」をジオコーディングする"

Apidog MCPサーバーとGoogle Maps MCPとの統合

Google Maps MCPサーバーとApidog MCPサーバーを組み合わせることで、AIアシスタントがGoogleの位置情報サービスとカスタムAPI仕様の両方にアクセスできる強力で統合された開発環境が作成されます。

Apidog MCPサーバーの設定

Apidog MCPサーバーは、三つの主要なデータソースをサポートしています:

  1. Apidogプロジェクト:Apidogチーム内のAPI仕様に接続します。
  2. オンラインAPIドキュメント:Apidogを通じて公開されている一般に利用可能なAPIドキュメントにアクセスします。
  3. OpenAPIファイル:ローカルまたはオンラインのSwagger/OpenAPIファイルを読み取ります。

前提条件:

  • Node.js(バージョン18以上)
  • APIプロジェクトにアクセスできるApidogアカウント
  • Apidog APIアクセストークンとプロジェクトID

構成手順:

Apidogアクセス・トークンを生成する

  • Apidogアカウントにログインします。
  • アカウント設定 > APIアクセス・トークンに移動します。
  • 新しいトークンを作成し、安全な場所にコピーします。
Apidogで新しいAPIアクセス・トークンを作成

ApidogプロジェクトIDを見つける

  • Apidogでプロジェクトを開きます。
  • 左側のサイドバーで設定に移動します。
  • 基本設定からプロジェクトIDを見つけてコピーします。
Apidogで新しいプロジェクトIDをコピー

Google MapsとApidog MCPサーバーを組み合わせる

AIツールで両方のMCPサーバーを統合するには、構成ファイルを更新します:

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    },
    "API仕様": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--project=<project-id>"
      ],
      "env": {
        "APIDOG_ACCESS_TOKEN": "<access-token>"
      }
    }
  }
}

<YOUR_API_KEY><project-id><access-token>を実際の値に置き換えます。

統合の確認

両方のMCPサーバーが連携していることを確認するには:

AIアシスタントにGoogle Maps操作を実行させます:

"Google Mapsを使用してサンフランシスコの近くのレストランを探す"

次に、ApidogでカスタムAPIについて尋ねます:

"Apidog MCPを介して私のAPI仕様を取得し、利用可能なエンドポイントについて教えて"

実用的なアプリケーション:Google Maps MCPとApidog MCPを活用する

Google Maps MCPサーバーとApidog MCPサーバーの組み合わせは、API開発を変革する強力なワークフローを作成します。

AIアシスタンスを活用した位置情報対応アプリケーションの構築

両方のMCPサーバーが構成されると、開発者は:

Google Maps統合コードを生成する

"住所をジオコーディングし、地図に表示するためのTypeScriptコードを生成する"

AIは、Google Maps APIパターンを正しく実装するコードを作成します。

カスタムAPIエンドポイントを実装する

"ApidogのAPI仕様に基づいて、ユーザーの位置情報を保存するエンドポイントを作成する"

AIは、APIドキュメントと完全に一致するサーバーサイドコードを生成できます。

データ変換関数を作成する

"Google Mapsの場所データを私たちの内部位置スキーマに一致させる関数を書く"

AIは、両方のデータ構造を理解し、正確な変換ロジックを作成できます。

実世界の開発シナリオ

シナリオ1:店舗検索アプリケーションの構築

開発者は、ユーザーが近くの店舗を見つけるのを助けるシステムを作成する必要があります。統合されたMCPサーバーを使用すると、彼らは:

  • 位置検索のためのGoogle Maps APIクライアントコードを生成する
  • 店舗情報を保存および取得するためのカスタムAPIエンドポイントを作成する
  • ユーザーの位置と店舗間の距離計算を実装する
  • 両方のシステムでの正しい動作を検証する包括的なテストを生成する

シナリオ2:配送追跡システムの作成リアルタイムで配送を追跡するシステムを構築する際、開発者は:

  • Google Maps Directions APIを使用してルート最適化コードを生成する
  • 配送ステータス更新のためのカスタムエンドポイントを作成する
  • 交通条件に基づいてETA計算を実装する
  • 統合パターンを説明するドキュメントを生成する

結論:Google MapsとApidog MCPの統合によるAPI開発の変革

Google Maps MCPサーバーとApidog MCPサーバーの統合は、API開発手法において重要な進歩を示しています。AIアシスタントがGoogleの位置情報サービスとカスタムAPI仕様の両方にアクセスできる統一された環境を作ることで、この組み合わせは、複数のAPIシステムでの作業に伴う持続的な課題に対処します。

この統合アプローチは、開発ライフサイクル全体にわたって具体的なメリットを提供します。開発者は、ドキュメントソースを切り替えるために費やす時間が減り、より価値のあるものを作成することにより多くの時間を費やします。コード生成は、Google Mapsの要件とカスタムAPI仕様の両方と完全に一致しています。

位置情報に基づく機能に依存する企業にとって、この統合はこれらの機能の構築と維持の方法を変革します。Google Mapsの強力な位置機能とカスタムバックエンドサービスの組み合わせは、AIの支援により、アプリケーションアーキテクチャ全体で一貫性を確保することで、より管理しやすくなります。

Google Maps MCPサーバーとApidog MCPサーバーの統合を受け入れることで、開発チームは現代のAPI開発プラクティスの最前線に立ち、より良く、一貫した統合を短時間で提供できるようになります。