翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 静的マップ
**注記**
静的マップは、スタンダードスタイルと衛星スタイルのみをサポートします。詳細については、「[AWS マップスタイルと機能](map-styles.md)」を参照してください。
静的マップは、アプリケーションに必要なマーカー (またはピン)、ルート、ポリゴン領域をオーバーレイするオプションを使用して、地理的データを事前にレンダリングして表現します。静的マップを使用すると、カスタマイズ可能なパラメータとデータ入力に基づいて静的 (非インタラクティブ) マップイメージを生成できます。オーバーレイ、シェイプをカスタマイズ、またはカスタムスタイルを適用することにより、静的マップを使用すると、特定のニーズを満たすマップの視覚化を作成し、エンドユーザーエクスペリエンスを向上させ、地理的情報を効果的に伝達できます。サーバーはリクエストされたマップイメージをカスタマイズし、JPEG ファイルとしてクライアントに配信します。特定の要件に合わせたマップイメージをプログラムでリクエストして生成できます。
*GetStaticMap API* は、中心座標、境界ボックス、オーバーレイなどの指定されたパラメータに基づいてマップの静的イメージを生成します。この API を使用すると、マップ機能とスタイルのカスタマイズが可能になり、インタラクティブなマップ機能を使用せずにウェブまたはモバイルアプリケーションで使用できます。
詳細については、「*Amazon Location Service API リファレンス*」の「[GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)」を参照してください。
この API のリクエスト、レスポンス、cURL、CLI コマンドの例については、「[静的マップの使用方法](https://docs.aws.amazon.com/location/latest/developerguide/static-maps-how-to.html)」を参照してください。
## 一般的なユースケース
+ **ウェブまたはモバイルアプリケーションの埋め込みマップ:** 静的マップイメージをウェブサイトまたはモバイルアプリケーションに効率的に埋め込み、非インタラクティブマップを使用して、場所、ルート、または対象となるポイントを視覚化できるため、ロード時間とデータ使用量を削減できます。例としては、POI の検索結果でマップイメージを表示する検索エンジン (Yahoo など) が含まれます。
+ **E メール内の場所の詳細:** 静的マップイメージを使用して、エンドユーザーが E メールのコンテキストを理解できるように、E メールで位置情報を共有できます。例えば、食品配送アプリやライドシェアアプリでは、静的マップイメージを使用して、集荷/返却場所、ルート、または周辺エリアを、旅行後または配送後の E メールに請求書と概要を含めて表示します。
+ **マーケティング資料と印刷されたドキュメント:** カスタマイズされた静的マップイメージを冊子、チラシ、またはその他の印刷物に組み込むことができ、コンテンツに関連する地理的情報の視覚的に魅力のある表現を提供します。
## リクエストを理解する
リクエストには、マップの可視領域とオーバーレイを定義する、`BoundingBox`、`BoundedPositions`、`Center` などのオプションの URI パラメータが含まれます。パラメータ `Height` および `Width` は、イメージサイズを定義するために必要です。詳細については、「[静的マップをカスタマイズする](customizing-static-maps.md)」および「[静的マップでのオーバーレイ](overlaying-static-map.md)」を参照してください。
+ `BoundedPositions`: イメージで網羅する座標。
+ `BoundingBox`: マップの南西エッジと北東エッジを定義する座標。
+ `Height`: イメージの高さを指定します。
+ `Width`: イメージの幅を指定します。
+ `GeoJsonOverlay`: オーバーレイを追加するための有効な GeoJSON オブジェクト。
## レスポンスを理解する
レスポンスには、`CacheControl`、`ContentType`、`ETag` などのヘッダーが含まれており、静的マップを JPEG 形式または PNG 形式のバイナリ BLOB として返します。ヘッダーは、キャッシュ制御、コンテンツタイプ、静的イメージのバージョンなどのメタデータを提供します。
+ `CacheControl`: マップイメージのキャッシュ設定を指定します。
+ `ContentType`: マップイメージの形式 (JPEG または PNG) を示します。
+ `ETag`: 静的マップイメージのバージョンを表す識別子。
+ `Blob`: JPEG 形式または PNG 形式でマップイメージを表します。
# 静的マップをカスタマイズする
**注記**
静的マップはサテライトスタイルのみをサポートします。詳細については、「[AWS マップスタイルと機能](map-styles.md)」を参照してください。
このセクションでは、Amazon Location Service を使用して生成された静的マップをカスタマイズする方法の概要を説明します。マップの位置、サイズ、言語、スケール、オーバーレイ、属性の調整など、さまざまな機能を対象としているため、特定の要件に合わせてマップを調整できます。
詳細については、「*Amazon Location Service API リファレンス*」の「[GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)」を参照してください。
## ポジション
位置を使用すると、マップの中心と境界を定義できます。マップのフォーカスを制御するには、中心座標、境界ボックスを設定するか、ズームレベルを使用して表示する領域を決定します。仕組みについては、「[特定の位置の静的マップを取得する方法](get-static-map-specific-position.md)」を参照してください。
+ `Center`: 経度と緯度の座標を使用してマップの中心点を定義します。
+ `Radius`: 静的マップに表示される半径 (中心からの距離) を指定します。
+ `Bounding Box`: マップの長方形領域を定義し、左上隅と右下隅の座標を指定して設定します。
+ `Zoom`: マップのズームレベルを制御します。ズームレベルが高いほど小さなエリアで詳細が表示され、ズームレベルが低いほど大きなエリアでの詳細が少なくなります。
## ディメンションと品質
静的マップのサイズと視覚的な品質をカスタマイズするには、ディメンション (高さと幅) を定義し、マーカーやその他の要素をより適切に表示するためのパディングを追加します。仕組みについては、「[特定のディメンションの静的マップを取得する方法](get-static-map-specific-dimension.md)」を参照してください。
+ `Height and Width`: 静的マップイメージの高さと幅をピクセル単位で定義して、そのサイズを指定します。
+ `Padding`: マップのエッジの周囲に余分なスペースを追加し、マーカー、線、またはシェイプを配置する際の視覚化を改善します。
## スケール
スケールはマップの縮尺を制御し、距離を測定する単位 (キロメートル、マイル) を定義します。これは、マップのサイズと距離の関係を正確に表すのに役立ちます。仕組みについては、「[静的マップにスケールを追加する方法](add-scale-static-map.md)」を参照してください。
+ `Scale Unit`: マップのスケールバーの単位 (キロメートルやマイルなど) を定義し、ユーザーがマップ上の距離を正確に測定できるようにします。
## オーバーレイ
マーカー、ルートを表示する線、エリアを表示するポリゴンなどを追加できます。仕組みについては、「[静的マップにマーカーを追加する方法](add-marker-static-map.md)」、「[静的マップに線を追加する方法](how-to-add-line-static.md)」、または「[ルートを静的マップに追加する方法](how-to-add-route.md)」を参照してください。
# 静的マップでのオーバーレイ
このセクションでは、Amazon Location Service を使用して追加情報を静的マップにオーバーレイする方法について説明します。静的マップをカスタマイズするには、点、線、ポリゴンなどのさまざまな地理的特徴を追加して、マップの視覚的表現を強化します。Amazon Location Service は、GeoJSON やコンパクトオーバーレイ形式などの複数の形式をサポートし、オーバーレイを追加する柔軟で効率的な方法を提供します。
詳細については、「*Amazon Location Service API リファレンス*」の「[GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)」を参照してください。
## GeoJSON を使用する
GeoJSON は、カスタムデータを静的マップにオーバーレイできる汎用形式です。点、線、ポリゴンなどの地理的特徴を定義することにより、マップの視覚的表現を強化し、ユーザーに貴重なコンテキストを提供できます。GeoJSON は広くサポートされており、マップオーバーレイのスタイルやカスタマイズに関して柔軟性があるため、リージョンの表示、ルートのプロット、空間関係の表示に最適な形式です。
Amazon Location Service を使用すると、GeoJSON を活用して、動的なロケーションベースの機能を静的マップに直接追加できます。これにより、特定のビジネスニーズに合わせて調整できる、高度にカスタマイズ可能なオーバーレイを作成できます。GeoJSON は、`Point`、`LineString`、`Polygon`、`MultiPolygon` など、複数のジオメトリタイプをサポートしているため、マーカーやルートから複雑なエリア表現まで、さまざまな特徴を表示できます。
## カラー
GeoJSON 機能のスタイル設定では、色を柔軟に定義できます。16 進値 (赤の場合は \$1ff0000) やアルファ透明度 (半透明赤の場合は \$1ff000080) など、さまざまな形式を使用して色を指定できます。これにより、オーバーレイをマップスタイルと視覚的に一致させることができます。色を指定しない場合、選択したマップスタイルのデフォルトの色が適用されます。
## 描画順序
カスタムオーバーレイは、明確さを維持し、視覚的に乱雑にならないように、特定の順序で描画されます。Amazon Location Service では、ポリゴン、線、点などのオーバーレイ機能は、ベースマップの上、マップラベルの下に表示されます。描画順序は、最初にポリゴンを優先し、次に線を優先し、次に点またはマーカーを優先します。
## 測定単位
`width` や `outline-width` などのプロパティでは、ピクセル (px)、メートル (m)、キロメートル (km)、マイル (mi)、パーセンテージ (%) など、さまざまな測定単位を使用してサイズを指定できます。パーセンテージ単位は、デフォルト値に対してプロパティを調整し、オーバーレイのスタイル設定の柔軟性を高めます。
## ジオメトリタイプ
Amazon Location Service は、`Point`、`LineString`、`Polygon`、`MultiPolygon` など、複数の GeoJSON ジオメトリタイプをサポートしています。各ジオメトリタイプは、GeoJSON のプロパティオブジェクトを使用してスタイルおよび調整できるため、マップ上のマーカー、ルート、および領域を広範囲にカスタマイズできます。
## コンパクトオーバーレイを使用する
**注記**
コンパクトオーバーレイは、点、線、ポリゴンのジオメトリタイプをサポートします。`multiPoint`、`multiLine`、および `multiPolgyon` はサポートされません。
コンパクトオーバーレイオプションを使用すると、単一のクエリパラメータを使用して、静的マップに複数のジオメトリを効率的に表示できます。この合理化されたアプローチにより、リクエスト形式が簡素化され、リクエストのサイズが小さくなり、オーバーレイデータの送信が容易になります。顧客はさまざまなジオメトリタイプとそれに対応するスタイルプロパティを 1 つのクエリパラメータに入力でき、Amazon Location Service は指定されたとおりにオーバーレイを解析してレンダリングすることにより、重要な処理を担当します。
コンパクトオーバーレイ形式を使用する場合は、リクエスト URL のサイズに制限があることに注意してください。Amazon Location Service はクエリを最適化しますが、特に複数のジオメトリと関連プロパティを処理する場合は、リクエストが妥当な制限内に収まるようにします。
## 形式
コンパクトオーバーレイ形式は次のように構成されています。`geometry_type:geometry;property_1=value_1;property_2=value_2|geometry_type:geometry;property_1=value_1...`
各ジオメトリタイプは、スタイルプロパティと共に定義されます。複数のジオメトリはパイプ演算子 (\$1) で区切られ、各ジオメトリのプロパティはセミコロンで区切られます。
## サポートされているジオメトリタイプ
Amazon Location Service は、`Point`、`MultiPoint`、`LineString`、`Polygon`、`MultiPolygon` など、複数のジオメトリタイプをサポートしています。これらのジオメトリタイプは、コンパクトオーバーレイ形式を使用して、同じクエリパラメータ内で組み合わせてスタイル付けできます。
## スタイルプロパティ
各ジオメトリは、色、アウトライン色、サイズなどのさまざまなスタイルプロパティを使用してカスタマイズできます。これらのプロパティを使用すると、マップ上の各ジオメトリの外観を制御でき、オーバーレイがビジネス要件と一致していることを確認できます。