静的マップ - Amazon Location Service
一般的なユースケースリクエストを理解するレスポンスを理解する

静的マップ

注記

静的マップはサテライトスタイルのみをサポートします。詳細については、「AWS マップスタイルとカスタマイズ」を参照してください。

静的マップは、アプリケーションに必要なマーカー (またはピン)、ルート、ポリゴン領域をオーバーレイするオプションを使用して、地理的データを事前にレンダリングして表現します。静的マップを使用すると、カスタマイズ可能なパラメータとデータ入力に基づいて静的 (非インタラクティブ) マップイメージを生成できます。オーバーレイ、シェイプをカスタマイズ、またはカスタムスタイルを適用することにより、静的マップを使用すると、特定のニーズを満たすマップの視覚化を作成し、エンドユーザーエクスペリエンスを向上させ、地理的情報を効果的に伝達できます。サーバーはリクエストされたマップイメージをカスタマイズし、JPEG ファイルとしてクライアントに配信します。特定の要件に合わせたマップイメージをプログラムでリクエストして生成できます。

GetStaticMap API は、中心座標、境界ボックス、オーバーレイなどの指定されたパラメータに基づいてマップの静的イメージを生成します。この API を使用すると、マップ機能とスタイルのカスタマイズが可能になり、インタラクティブなマップ機能を使用せずにウェブまたはモバイルアプリケーションで使用できます。

詳細については、「Amazon Location Service API リファレンス」の「GetStaticMap」を参照してください。

この API のリクエスト、レスポンス、cURL、CLI コマンドの例については、「静的マップの使用方法」を参照してください。

一般的なユースケース

  • ウェブまたはモバイルアプリケーションの埋め込みマップ: 静的マップイメージをウェブサイトまたはモバイルアプリケーションに効率的に埋め込み、非インタラクティブマップを使用して、場所、ルート、または対象となるポイントを視覚化できるため、ロード時間とデータ使用量を削減できます。例としては、POI の検索結果でマップイメージを表示する検索エンジン (Yahoo など) が含まれます。

  • E メール内の場所の詳細: 静的マップイメージを使用して、エンドユーザーが E メールのコンテキストを理解できるように、E メールで位置情報を共有できます。例えば、食品配送アプリやライドシェアアプリでは、静的マップイメージを使用して、集荷/返却場所、ルート、または周辺エリアを、旅行後または配送後の E メールに請求書と概要を含めて表示します。

  • マーケティング資料と印刷されたドキュメント: カスタマイズされた静的マップイメージを冊子、チラシ、またはその他の印刷物に組み込むことができ、コンテンツに関連する地理的情報の視覚的に魅力のある表現を提供します。

リクエストを理解する

リクエストには、マップの可視領域とオーバーレイを定義する、BoundingBox、BoundedPositions、Center などのオプションの URI パラメータが含まれます。パラメータ Height および Width は、イメージサイズを定義するために必要です。詳細については、「静的マップをカスタマイズする」および「静的マップでのオーバーレイ」を参照してください。

  • BoundedPositions: イメージで網羅する座標。

  • BoundingBox: マップの南西エッジと北東エッジを定義する座標。

  • Height: イメージの高さを指定します。

  • Width: イメージの幅を指定します。

  • GeoJsonOverlay: オーバーレイを追加するための有効な GeoJSON オブジェクト。

レスポンスを理解する

レスポンスには、CacheControl、ContentType、ETag などのヘッダーが含まれており、静的マップを JPEG 形式または PNG 形式のバイナリ BLOB として返します。ヘッダーは、キャッシュ制御、コンテンツタイプ、静的イメージのバージョンなどのメタデータを提供します。

  • CacheControl: マップイメージのキャッシュ設定を指定します。

  • ContentType: マップイメージの形式 (JPEG または PNG) を示します。

  • ETag: 静的マップイメージのバージョンを表す識別子。

  • Blob: JPEG 形式または PNG 形式でマップイメージを表します。