静的マップでのオーバーレイ

このセクションでは、Amazon Location Service を使用して追加情報を静的マップにオーバーレイする方法について説明します。静的マップをカスタマイズするには、点、線、ポリゴンなどのさまざまな地理的特徴を追加して、マップの視覚的表現を強化します。Amazon Location Service は、GeoJSON やコンパクトオーバーレイ形式などの複数の形式をサポートし、オーバーレイを追加する柔軟で効率的な方法を提供します。

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

GeoJSON を使用する

GeoJSON は、カスタムデータを静的マップにオーバーレイできる汎用形式です。点、線、ポリゴンなどの地理的特徴を定義することにより、マップの視覚的表現を強化し、ユーザーに貴重なコンテキストを提供できます。GeoJSON は広くサポートされており、マップオーバーレイのスタイルやカスタマイズに関して柔軟性があるため、リージョンの表示、ルートのプロット、空間関係の表示に最適な形式です。

Amazon Location Service を使用すると、GeoJSON を活用して、動的なロケーションベースの機能を静的マップに直接追加できます。これにより、特定のビジネスニーズに合わせて調整できる、高度にカスタマイズ可能なオーバーレイを作成できます。GeoJSON は、Point、LineString、Polygon、MultiPolygon など、複数のジオメトリタイプをサポートしているため、マーカーやルートから複雑なエリア表現まで、さまざまな特徴を表示できます。

カラー

GeoJSON 機能のスタイル設定では、色を柔軟に定義できます。16 進値 (赤の場合は #ff0000) やアルファ透明度 (半透明赤の場合は #ff000080) など、さまざまな形式を使用して色を指定できます。これにより、オーバーレイをマップスタイルと視覚的に一致させることができます。色を指定しない場合、選択したマップスタイルのデフォルトの色が適用されます。

描画順序

カスタムオーバーレイは、明確さを維持し、視覚的に乱雑にならないように、特定の順序で描画されます。Amazon Location Service では、ポリゴン、線、点などのオーバーレイ機能は、ベースマップの上、マップラベルの下に表示されます。描画順序は、最初にポリゴンを優先し、次に線を優先し、次に点またはマーカーを優先します。

測定単位

width や outline-width などのプロパティでは、ピクセル (px)、メートル (m)、キロメートル (km)、マイル (mi)、パーセンテージ (%) など、さまざまな測定単位を使用してサイズを指定できます。パーセンテージ単位は、デフォルト値に対してプロパティを調整し、オーバーレイのスタイル設定の柔軟性を高めます。

ジオメトリタイプ

Amazon Location Service は、Point、LineString、Polygon、MultiPolygon など、複数の GeoJSON ジオメトリタイプをサポートしています。各ジオメトリタイプは、GeoJSON のプロパティオブジェクトを使用してスタイルおよび調整できるため、マップ上のマーカー、ルート、および領域を広範囲にカスタマイズできます。

コンパクトオーバーレイを使用する

コンパクトオーバーレイオプションを使用すると、単一のクエリパラメータを使用して、静的マップに複数のジオメトリを効率的に表示できます。この合理化されたアプローチにより、リクエスト形式が簡素化され、リクエストのサイズが小さくなり、オーバーレイデータの送信が容易になります。顧客はさまざまなジオメトリタイプとそれに対応するスタイルプロパティを 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...

各ジオメトリタイプは、スタイルプロパティと共に定義されます。複数のジオメトリはパイプ演算子 (|) で区切られ、各ジオメトリのプロパティはセミコロンで区切られます。

サポートされているジオメトリタイプ

Amazon Location Service は、Point、MultiPoint、LineString、Polygon、MultiPolygon など、複数のジオメトリタイプをサポートしています。これらのジオメトリタイプは、コンパクトオーバーレイ形式を使用して、同じクエリパラメータ内で組み合わせてスタイル付けできます。

スタイルプロパティ

各ジオメトリは、色、アウトライン色、サイズなどのさまざまなスタイルプロパティを使用してカスタマイズできます。これらのプロパティを使用すると、マップ上の各ジオメトリの外観を制御でき、オーバーレイがビジネス要件と一致していることを確認できます。