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. <ph type="x-smartling-placeholder"></ph> 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" というテキストが表示された黄色のエラーバーが重ねて表示されます。

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

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 ウェブ コンソール、またはブラウザの同等のツールです。