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

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

無効なリクエスト

無効なリクエストを受け取ると、Maps Static API は HTTP 4xx ステータス コードと問題の詳細を説明するメッセージを返します。次に、このエラーが発生する条件の例を示します。注: これは、発生する可能性があるすべてのエラーを網羅してはいません。実際のエラーコードと、API が返す特定の問題についての詳しいメッセージを確認してください。

エラーによって地図が表示されない場合

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

API キーと課金に関連するエラー

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

キーレスのエラーと解決策
	API キーなしで Maps Static API を使用している。解決するには、次の操作を行います。 API キーを取得する 課金を有効にする URL に署名する
	リクエストにデジタル署名がありません（必須）。解決するには、 URL に署名します。

警告

エラー条件によっては、API が返す地図にいくつかの情報が表示されないことがあります。エラーが発生した場合、次の 2 つの方法で警告が通知されます。

• マップは表示されますが、その上に "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 ヘッダーとして出力する可能性がある警告を示します。

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