Maps Static API のエラー メッセージ

なんらかの問題が発生すると、Maps Static API からエラーや警告が返されることがあります。このガイドでは、各エラー メッセージについて説明し、エラーを解決するための詳細な手順を示します。

無効なリクエスト

リクエストが無効の場合、Maps Static API は HTTP 4xx ステータス コードと、問題を説明するメッセージを返します。このようなエラー状態の例を次に示します。注: このリストはすべてのエラーを網羅しているわけではありません。問題の詳細については、API から返される実際のエラーコードとメッセージを確認してください。

エラー発生条件の例 ステータス コード
リクエストに無効なパラメータが含まれているか、必須パラメータがありません。たとえば、size パラメータが想定された数値の範囲外か、リクエストに含まれていません。 400 BAD REQUEST
リクエストに含まれている API キーが無効です。 403 FORBIDDEN

エラーが原因で地図が表示されない

リクエストが有効であっても、別のエラーが発生して地図を表示できない場合、Maps Static API はエラーに応じて、地図の代わりにテキストまたはエラー画像を返します。このようなエラー状態の例としては、アプリケーションが使用量上限を超えた場合などがあります。

地図の代わりに表示されるエラー画像
図: 地図の代わりに表示されたエラー画像

API キーなしで Maps Static API を使用する場合、またはアカウントで課金が有効になっていない場合は、地図の代わりにエラー画像がページに表示され、エラーの種類を示すリンクも併せて表示されます。(例: g.co/staticmaperror/key)。

キーレスエラーと解決策
使用制限のエラー: 提供された 1 日あたりの地図の読み込み上限を超えました API キーなしで Maps Static API を使用しています。この問題を解決するには、次の操作を行います。
  1. API キーを取得
  2. 課金を有効にする
  3. URL に署名する
使用制限のエラー: リクエスト URL にデジタル署名がありません リクエストにデジタル署名がありません(必須)。この問題を解決するには、 URL に署名するをご覧ください。

警告

エラー条件によっては、API から地図が返されますが、地図に情報の一部が欠けている場合があります。この場合、2 つの条件に基づいて警告が通知されます。

  • 1 つ目は、地図が表示されますが、その上に黄色のエラーバーが重なって、「Map error: g.co/staticmaperror」というテキストが表示されています。
  • 2 つ目は、API が X-Staticmap-API-Warning という名前の HTTP ヘッダーの形式で警告を返すことです。

たとえば、次の URL の markers パラメータに想定外の値が含まれています。

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY

API から地図が返されますが、「Map error: g.co/staticmaperror」と書かれた黄色のエラーバーが画像の上に重ねて表示されます。

マップは表示されるが、"Map error: g.co/staticmaperror" というテキストが表示される

API は次の HTTP ヘッダーも返します。

X-Staticmap-API-Warning:Error geocoding: marker 1

次の表に、API が HTTP ヘッダーとして発行する可能性のある警告を示します。

X-Staticmap-API-Warning ヘッダー内の警告
Error geocoding: [center, ][marker #number, ][visible #num, ][path #num, ]* リクエストのジオコーディング中にエラーが発生しました。このメッセージには、ジオコーディングが失敗した要素(中心、マーカー、可視、パス)と、失敗した要素の数に応じてさまざまなバリエーションがあります。この警告の例としては、上記の例に示すように X-Staticmap-API-Warning:Error geocoding: marker 1 が挙げられます。
Too many geocoded markers requested (max is 15). リクエストで、人間が読める住所を持つマーカーが最大許容数を超えています。最大 15 個です。なお、この制限は、ジオコーディングが必要な、人が読める形式の住所として指定されたマーカーにのみ適用されます。緯度と経度の座標で指定されたマーカーには適用されません。
Too many geocoded polyline vertices requested (max is 15). リクエストで、人が読める住所を持つポリラインが最大許容数を超えています。最大 15 個です。なお、この制限は、ジオコーディングが必要な、人間が読める住所として指定された頂点を持つポリラインにのみ適用されます。緯度と経度の座標で指定されたポリラインには適用されません。

HTTP ヘッダーの警告は、Chrome DevTools ConsoleFirefox ウェブ コンソール、またはお使いのブラウザの他の同等のツールで確認できます。