開発

Google Maps APIの使い方|料金・無料枠とAPIキー制限、実装コード

Google Maps APIの使い方|料金・無料枠とAPIキー制限、実装コード

Google Maps APIは、Webサイトや業務システムに地図表示・住所から緯度経度への変換・施設検索を組み込むためのAPI群で、正式にはGoogle Maps Platformと呼ばれます。2025年3月1日に月200ドルの無償クレジットが廃止され、APIごとの無料枠に切り替わったため、以前の記事の試算はそのまま使えません。この記事では2026年11月16日時点の公式情報をもとに、SKU別の単価と無料枠、APIキーの制限とクォータの設定、Maps JavaScript API・Geocoding API・Places API (New)の実装コード、採用を見送る場面までを扱います。

まとめ:Google Maps APIで最初に決める使うAPI・料金上限・キー制限

Google Maps APIの費用は「どのAPIを、どのフィールドで、月に何回呼ぶか」で決まります。地図表示のDynamic MapsとGeocodingは月1万件まで無料ですが、施設名を返すText Searchは月5,000件を超えると1,000件あたり32ドルです。実装前に呼ぶAPIと月間回数を見積もり、1日あたりのクォータで上限を掛けておけば、請求の上振れは防げます。

APIキーはブラウザ用とサーバー用で分け、前者はHTTPリファラー、後者はIPアドレスで制限します。Geocodingで取った座標は30日までしか保存できないため、顧客マスタに残す対象はplace_idです。店舗名や営業時間などGoogleの施設データが要らない案件なら、Mapboxや自前タイルのほうが安く収まります。

Google Maps Platformの主要API:地図表示・住所変換・施設検索の分担

「Google Maps API」という単一の商品は無く、用途ごとに別のAPIを有効化して、それぞれの課金単位(SKU)で請求されます。

地図表示・住所変換・施設検索それぞれのAPI名と課金のSKU区分

業務システムでよく使う組み合わせを、Google Maps Platformの料金表から抜き出しました。単価は米ドル建てで、無料枠を超えてから月10万件までの区間の値です。

用途 API・SKU 区分 月の無料枠 1,000件あたり
Web画面の地図表示 Dynamic Maps(JS API) Essentials 10,000 7.00ドル
住所から緯度経度 Geocoding API Essentials 10,000 5.00ドル
入力中の候補表示 Autocomplete Requests Essentials 10,000 2.83ドル
施設の名称・住所検索 Text Search Pro Pro 5,000 32.00ドル
地図の埋め込み表示 Maps Embed API Essentials 無制限 0ドル

単価は10万件を超えると段階的に下がり、Dynamic Mapsなら10万1件目から5.60ドルです。この段階は請求先アカウントに紐づく全プロジェクトの合計で判定されるため、社内の別システムと同じアカウントを使うと区間が早く進みます。

2025年3月1日に変わった無料枠の仕組みとレガシー扱いになったAPI

2025年3月の変更点をまとめた公式ページによると、全SKU合計で月200ドルまで無料だったクレジットは、SKUごとの月間無料枠に置き換えられました。枠はEssentialsが1万件、Proが5,000件、Enterpriseが1,000件です。各SKUの単価そのものは据え置かれています。

同じ日に、Places API・Directions API・Distance Matrix APIがレガシー扱いになりました。レガシー製品の一覧は、後継としてPlaces API (New)とRoutes APIを挙げ、新規プロジェクトではレガシーAPIを無効のままにするよう案内しています。廃止日は未定で、決まれば12か月以上前に通知される扱いです。新しく書くコードは、最初から後継APIで組みます。

APIキーの発行から制限設定まで:本番で請求事故を防ぐGoogle Cloud側の準備

APIキーの不正利用で発生した請求は、利用者の負担になると公式に明記されています。コードより先に、Google Cloud側の設定を固めます。

プロジェクト作成・請求先アカウント・APIの有効化を行う順番と注意点

  1. Google Cloudコンソールでプロジェクトを作成し、請求先アカウントを紐づける
  2. 「APIとサービス」のライブラリから、使うAPI(Maps JavaScript API、Geocoding APIなど)だけを有効化する
  3. 「認証情報」でAPIキーを作成し、すぐにアプリケーション制限とAPI制限を設定する
  4. 本番用と開発用でキーを分け、開発用にはlocalhostを許可する

請求先アカウントを紐づけ忘れると、地図は表示されても暗くなり、「For development purposes only」の透かしが入ります。キーを作った直後は制限なしの状態なので、手順3を後回しにしないでください。

HTTPリファラー制限とIP制限をブラウザ用・サーバー用キーで分ける設定

Google Maps Platformのセキュリティガイドは、1つのキーに掛けるアプリケーション制限を1種類にし、用途ごとにキーを分けるよう推奨しています。業務システムでは次の2本立てが基本です。

キー アプリケーション制限 API制限で許可するAPI
ブラウザ用 Webサイト(HTTPリファラー) Maps JavaScript API
サーバー用 IPアドレス Geocoding、Places (New)

ブラウザ用キーはページのソースから誰でも読めます。リファラー制限で自社ドメイン以外からの利用を拒否させ、API制限で地図以外のAPIを呼べない状態にする設定も必要です。GeocodingやPlacesをサーバーから呼ぶキーは公開しない前提で、NAT配下ならGoogle側から見えるグローバルIPを登録します。ガイドはクライアント側とサーバー側でプロジェクト自体を分ける構成も勧めており、漏えい時に止める範囲を小さくできます。同じGoogle Cloud上のAPIキー制限とクォータ設計は、YouTube Data API v3の使い方:新クォータ制とAPIキー・OAuth、Python実装でも実装例とあわせて解説しています。

予算アラートでは止まらない請求を1日あたりのクォータで止める方法

予算アラートは通知だけです。費用管理の公式ページは「予算を設定しても利用や支出は自動では上限で止まらない」と明記しています。

確実に止めるには、Cloudコンソールの「割り当て(Quotas)」でAPIごとの1日あたりの上限を下げます。上限に達すると、その日の残りはそのAPIへのリクエストが失敗する仕組みです。たとえばGeocodingの想定が月3万件なら、1日1,500件程度に設定しておくと、キーが漏れても被害は1日分で止まります。業務が止まる副作用もあるため、上限到達を監視して担当者に通知する仕組みとセットで入れます。

Maps JavaScript APIで地図とマーカーを表示する最小構成のコード

Maps JavaScript APIの読み込みガイドは、必要なライブラリだけを後から読む動的インポートを推奨しています。ここではnpm版のローダーを使います。

js-api-loader 2.1系でmapsとmarkerを読み込む地図表示コード

@googlemaps/js-api-loaderは2026年11月16日時点の最新版が2.1.3(Apache-2.0)です。npm install @googlemaps/js-api-loaderで導入し、setOptionsでキーを渡してからimportLibraryで読み込みます。

import { setOptions, importLibrary } from '@googlemaps/js-api-loader';

setOptions({ key: 'ブラウザ用のAPIキー' });

async function init() {
  // 複数ライブラリは Promise.all で並列に読む(公式の推奨)
  const [{ Map }, { AdvancedMarkerElement }] = await Promise.all([
    importLibrary('maps'),
    importLibrary('marker'),
  ]);

  const tokyo = { lat: 35.681, lng: 139.767 }; // {緯度, 経度} の順
  const map = new Map(document.getElementById('map'), {
    center: tokyo,
    zoom: 14,
    mapId: 'DEMO_MAP_ID', // 本番はCloudコンソールで作成したマップIDに置き換える
  });

  new AdvancedMarkerElement({ map, position: tokyo, title: '本社' });
}

void init();

地図を描く要素にはheightを必ず指定します。高さ0のままだと、エラーが出ないまま何も表示されません。

非推奨のMarkerを避けAdvancedMarkerElementとマップIDで打つ

Advanced Markersへの移行ガイドによると、従来のgoogle.maps.Markerは2024年2月21日のv3.56で非推奨になりました。削除日は示されていませんが、古い記事のサンプルをそのまま写すとこのクラスを使ってしまいます。

後継のAdvancedMarkerElementはマップIDが必須です。検証ではDEMO_MAP_IDで動きますが、本番ではCloudコンソールでマップIDを発行して差し替えます。マーカーの中身にHTML要素を渡せるので、拠点ごとに色分けしたピンや件数バッジも画像を用意せずに作れます。

地図が暗く表示されるときにコンソールで確かめるエラーコード5種

地図が出ない原因は、ほぼ設定側にあります。エラーメッセージの公式一覧から、頻度の高いものを並べました。

  • RefererNotAllowedMapError:表示中のURLがキーのリファラー制限に入っていない
  • BillingNotEnabledMapError:プロジェクトに請求先アカウントが紐づいていない
  • ApiNotActivatedMapError:Maps JavaScript APIを有効化していない
  • ApiTargetBlockedMapError:キーのAPI制限で、使うAPIが許可されていない
  • InvalidKeyMapError:指定したキーが存在しない

本番だけ表示されない場合は、まずRefererNotAllowedMapErrorを疑います。ステージング環境のドメインを足し忘れる例が典型です。

サーバー側で住所を座標に変えるGeocoding APIと施設検索のPlaces API

住所変換と施設検索は、サーバー用キーでバックエンドから呼びます。ブラウザから直接呼ぶと、キーと呼び出し回数を利用者側に握られるためです。

region=jp指定のGeocoding呼び出しとlocation_typeの判定

Geocoding APIのリクエスト仕様では、addressとキーが必須です。region=jpで日本の結果を優先させ、language=jaで住所を日本語で受け取ります。

curl -s "https://maps.googleapis.com/maps/api/geocode/json?address=東京都千代田区丸の内1-9-1&region=jp&language=ja&key=${GMAPS_SERVER_KEY}"

応答ではstatusを最初に見ます。OK以外に、結果が無いZERO_RESULTS、キーや権限が原因のREQUEST_DENIED、クォータ超過のOVER_QUERY_LIMITがあります。geometry.location_typeがROOFTOPなら建物単位、APPROXIMATEなら大まかな位置です。partial_matchが付いた結果は番地の誤りなどで一部しか一致していないので、配送先や訪問先に使うなら人の確認に回します。公式はformatted_addressをプログラムで分解しないよう求めており、都道府県や市区町村はaddress_componentsから取り出します。

緯度経度は30日で削除しplace_idだけ保持するデータベース設計

見落とされやすいのが保存の規約です。Geocoding APIのポリシーは、緯度経度のキャッシュを連続30暦日までとし、期限後は削除するよう定めています。一方でplace_idは無期限に保存できます。

import json, os, urllib.parse, urllib.request
from datetime import datetime, timedelta, timezone

KEY = os.environ["GMAPS_SERVER_KEY"]  # IP制限を掛けたサーバー用キー

def geocode(address):
    q = urllib.parse.urlencode(
        {"address": address, "region": "jp", "language": "ja", "key": KEY})
    url = "https://maps.googleapis.com/maps/api/geocode/json?" + q
    with urllib.request.urlopen(url, timeout=10) as r:
        data = json.load(r)
    if data["status"] == "ZERO_RESULTS":
        return None
    if data["status"] != "OK":
        raise RuntimeError(data["status"])  # REQUEST_DENIED は設定ミス
    top = data["results"][0]
    return {
        "place_id": top["place_id"],                  # 無期限で保存してよい
        "lat": top["geometry"]["location"]["lat"],    # 30日以内に削除する
        "lng": top["geometry"]["location"]["lng"],
        "location_type": top["geometry"]["location_type"],
        "partial_match": top.get("partial_match", False),
        "delete_after": (datetime.now(timezone.utc) + timedelta(days=30)).isoformat(),
    }

座標の列にはdelete_afterを持たせ、日次バッチで期限切れを消して必要時に再取得します。顧客マスタ全件の座標を恒久的に持ちたい要件なら、この規約と合いません。その場合は保存に制約の少ない別のジオコーダを検討します。住所データの座標系や取り込み設計はWeb GISのタイル配信とライブラリ選定でも扱っています。

なお、2026年11月時点ではGeocoding API v4がプレビューとして公開され、建物の入口やナビ用の地点まで返すSearchDestinationsが加わっています。プレビュー中は毎秒25件の上限があるため、本番の新規実装は上記のv3系で組むのが無難です。

Text Search (New)はフィールドマスクで課金区分が決まる仕組み

Places API (New)のText Searchは、返してほしい項目をX-Goog-FieldMaskヘッダで必ず指定します。省略するとエラーです。

curl -X POST "https://places.googleapis.com/v1/places:searchText" \
  -H "Content-Type: application/json" \
  -H "X-Goog-Api-Key: ${GMAPS_SERVER_KEY}" \
  -H "X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress,places.location" \
  -d '{"textQuery": "東京駅 コワーキングスペース", "languageCode": "ja", "regionCode": "JP"}'

課金区分は、指定したフィールドの中で最も高いSKUに決まるとPlaces APIの課金ページに書かれています。places.idだけならEssentials(IDs Only)で無料枠は無制限ですが、places.displayNameやplaces.locationを1つでも足すとProになり、月5,000件を超えた分は1,000件あたり32ドルです。ratingやnationalPhoneNumberを足すとEnterpriseに上がります。一覧ではIDだけを取り、利用者が選んだ1件の詳細だけを取りに行く設計にすると、請求額を大きく抑えられます。Nearby Search・Place Details・Autocompleteを含むPlaces API (New)の4エンドポイントとセッション課金の詳細は別記事で実装コードつきで整理しています。

料金試算と採用判断:Google Maps APIを選ぶ業務システムと見送る場面

Google Maps APIの強みは施設データの厚さと、利用者が見慣れた地図であることです。逆に、自社データを地図に重ねるだけの用途では割高になります。

月間表示1万・5万・20万回で比べるDynamic Mapsの請求額の目安

Dynamic Mapsは、ページで地図を初期化するたびに1回と数えます。拡大・移動では増えません。料金表の段階単価を当てはめた試算は次のとおりです。

月間の地図表示 無料分 課金対象 請求額の目安
1万回 1万回 0回 0ドル
5万回 1万回 4万回 約280ドル
20万回 1万回 19万回 約1,190ドル

20万回の内訳は、10万回までの9万回が7.00ドル、残り10万回が5.60ドルの区間です。ここに住所検索や施設検索の分が加わります。同じ表示回数で比べると、Mapboxの料金と実装手順はWeb地図が月5万ロードまで無料で、20万回でも請求は小さくなります。SPAで画面遷移のたびに地図を作り直す実装は表示回数を数倍に増やすので、地図のインスタンスは1つだけ保持してください。

Googleの施設データが要る案件だけに使い自社データ表示は他へ回す判断

Google Maps APIを採用するのは、店舗名・住所・営業時間などGoogleが持つ施設情報を検索や入力補完に使いたい案件です。来店予約の店舗検索、訪問先の住所入力補完、一般消費者向けアプリの地図画面が当てはまります。会社案内に所在地を1つ出すだけなら、無料で回数制限も無いMaps Embed APIで足ります。

見送るのは次の場面です。自社の拠点・設備・配送エリアを重ねるだけで月数十万回表示する業務画面は、MapboxやMapLibreのほうが安く済みます。座標を恒久的にデータベースへ持ちたい案件は30日規約と衝突する要件です。国内の住宅地図レベルの精度が要件ならZENRIN Maps APIの料金と無料枠、AWS内で完結させたいならAmazon Location Serviceの機能と料金を比較対象に入れます。

地図APIを既存の基幹システムや顧客管理と連携させる設計・実装を外部に任せたい場合は、API開発・システム連携のサービスページで対応範囲を確認できます。

よくある質問

Google Maps APIの導入前によく出る疑問に答えます。

Google Maps APIは無料で使えますか?

SKUごとの月間無料枠の範囲なら請求は発生しません。地図表示とGeocodingは月1万件、Proの施設検索は月5,000件までです。ただし本番利用には請求先アカウントの登録が必要で、枠を超えると自動で従量課金に移ります。試作だけなら、個人のGoogleアカウントでクレジットカード無しに取得できるMaps Demo Keyがあります。1日の上限に達するとその日は停止し課金されませんが、本番利用は想定されておらず、Google Workspaceのアカウントでは取得できません。

Places APIとPlaces API (New)はどちらを使えばよいですか?

新規開発ならPlaces API (New)です。旧Places APIは2025年3月1日にレガシー扱いになり、新機能は追加されません。New版はエンドポイントがplaces.googleapis.comに変わり、返す項目をフィールドマスクで指定する方式になりました。旧版のfindplacefromtextなどを使う既存システムは、廃止通知を待たずに移行計画を立てておくと、通知から12か月の猶予を検証期間に充てられます。

APIキーをHTMLに書いても問題ありませんか?

Maps JavaScript API用のキーはブラウザに渡る前提の仕組みなので、HTMLに書くこと自体は避けられません。その代わりHTTPリファラー制限とAPI制限を必ず掛け、自社ドメインから地図APIしか呼べない状態にします。GeocodingやPlacesを呼ぶキーは、HTMLやJavaScriptに書いてはいけません。サーバー側の環境変数に置き、IPアドレス制限を掛けます。漏えいに気づいたら、Cloudコンソールの認証情報からキーを削除して作り直します。

Googleマップの埋め込みとMaps JavaScript APIはどう違いますか?

Maps Embed APIはiframeで地図を貼る方式で、公式の課金ページは無料で回数制限も無いとしています。APIキーは必要です。表示できるのは決まった形式の地図で、独自のマーカーを複数打つ、クリックで業務データを出すといった制御はできません。所在地を見せるだけならEmbed、自社データと連動させるならJavaScript APIと使い分けます。

Google Maps APIの代わりにOpenStreetMapを使えますか?

地図の背景としては使えますが、Googleの施設検索や入力補完の代わりにはなりません。OpenStreetMapの地図データは利用条件を守れば商用でも使えます。一方、公式のタイルサーバーは大量アクセスを想定しておらず、業務システムではタイル配信サービスとの契約か自前配信が必要です。利用条件とAPIの範囲はOpenStreetMapの商用利用の条件で確認できます。

関連記事

お気に入りに入れた記事の一覧

一創の公式 SNS

X では毎朝の新着記事と IT ニュースの速報を、YouTube・TikTok・Instagram・LinkedIn・Facebook では記事の解説動画を配信しています。

この記事は以下の記事からリンクされています

資料請求

今日のトレンド記事 直近 24 時間で、いつもより多く読まれている記事

  1. 2026.11.13 テックブログ 宝くじ公式サイト不正アクセス:4,436名の対象確認とパスワード再設定、変更された仕組み
  2. 2026.11.14 テックブログ Gitの脆弱性6件:CVE-2026-111760の再帰クローン対策と2.56.1への更新手順
  3. 2026.11.14 テックブログ ImageMagickの脆弱性VU#580079:policy.xmlの許可リスト設定と影響判定の手順
  4. 2026.11.14 テックブログ Check Point脆弱性CVE-2026-123039:Gaiaのroot権限昇格を確かめるコマンドと侵害調査の手順
  5. 2026.11.13 テックブログ KARTEの不正アクセス:JINS約1,829万件など利用企業の漏えい一覧と、タグ・配信・データ連携を確かめる手順【11月17日時点】

RELATED POSTS 関連記事

目次