何かが起こると、Maps Static API がエラーや警告を発することがある 間違いですこのガイドでは、各エラー メッセージについて説明し、エラーを解決するための詳細な手順を説明します。
無効なリクエスト
無効なリクエストを受け取ると、Maps Static API は HTTP 4xx
ステータス コードと問題の詳細を説明するメッセージを返します。以下に、そのようなエラー条件の例を示します。注: これは、
考えられるエラーの完全なリストをご覧ください。実際のエラーコードをご確認ください
および API から返されたメッセージについて確認できます。
エラー発生条件の例 | ステータス コード |
---|---|
リクエストに無効なパラメータが含まれているか、必須パラメータが
ありません。たとえば、size パラメータは
期待される数値範囲であるか、リクエストにありません。 |
400 BAD REQUEST |
リクエストに含まれている API キーが無効です。 | 403 FORBIDDEN |
地図を表示できないエラー
リクエストは有効であっても、別のエラーが発生してマップが 表示されると、Maps Static API はテキストかエラーのいずれかを返します エラーに応じて、地図の代わりに画像が表示されます。このようなエラーの例 アプリケーションが上限を超えた状態を 使用量上限。

API キーと課金に関連するエラー
API キーなしで Maps Static API を使用する場合、または が有効になっていない場合、ページには エラーのタイプを示すリンクが表示されます。たとえば、「g.co/staticmaperror/key」です。
キーレスのエラーと解決策 | |
---|---|
![]() |
API キーなしで Maps Static API を使用しています。解決するには、次の作業が必要です。
|
![]() |
リクエストにデジタル署名がありません(必須)。解決するには、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" というテキストが表示された黄色のエラーバーが重ねて表示されます。

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, ]* |
リクエストをジオコーディングする際にエラーが発生しました。ジオコーディングが失敗した要素の種類(center、marker、visible、path)や数によって、メッセージは異なります。この警告の例としては
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 Console: Firefox ウェブ コンソール、またはブラウザの同等のツールです。