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 は地図を返しますが、地図に一部の情報が欠落している可能性があります。この場合、次の条件を使用して警告を特定できます。
- 地図の上に黄色のエラーバーが重ねて表示され、「地図エラー: g.co/staticmaperror」というテキストが表示されます。
- 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 は地図を返しますが、画像に「地図エラー: 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 デベロッパー ツールのコンソール、Firefox ウェブ コンソール、またはブラウザの同等のツールで確認できます。