スプライトを使用したアイコノグラフィーのスタイル
スプライトは、マップ上にレンダリングされたアイコン、マーカー、その他の要素などの小さなラスターイメージを含むポータブルネットワークグラフィック (PNG) イメージファイルです。スプライトは、スタイル、カラースキーム、バリアントなどのパラメータに基づいてカスタマイズできます。Amazon Location Service は、GetSprites API を通じてスプライトシートを提供します。独自のアイコンセットをロードするか (「マップにアイコンを追加する方法」を参照)、スタイル記述子をカスタマイズしてカスタムスプライトをロードすることにより、カスタムアイコンを使用することもできます。
詳細については、「Amazon Location Service API リファレンス」の「GetSprites」を参照してください。
ユースケース
-
特定のスタイルとカラースキームのスプライトシートを使用してカスタムマップ要素をレンダリングします。
-
スタンダード、モノクローム、ハイブリッドなど、さまざまなマップスタイルのスプライトを取得します。
-
スプライトを変更してマップ上のアイコノグラフィーをカスタマイズします。
リクエストを理解する
リクエストには、ColorScheme、FileName、Style などの URI パラメータが必要です。これらのパラメータにより、マップのカラースキーム、スタイル、必要な特定のスプライトファイルに基づいてスプライトシートをカスタマイズできます。
-
ColorScheme: 「ライト」や「ダーク」など、スプライトのカラースキームを定義します。 -
FileName: 取得するスプライトファイルの名前。PNG ファイルまたは JSON ファイルです。 -
Style: 「スタンダード」や「モノクローム」などのマップスタイルを指定します。
レスポンスを理解する
レスポンスには、CacheControl、ContentType、ETag などのヘッダーが含まれ、スプライトデータはバイナリ BLOB または JSON ファイルとして返されます。これらのヘッダーは、キャッシュ情報、レスポンスのコンテンツタイプ、スプライトデータのバージョン管理を提供します。
-
CacheControl: スプライトファイルのキャッシュ設定。 -
ContentType: PNG または JSON データが含まれているかどうかを示すレスポンスの形式。 -
ETag: キャッシュ検証に使用されるスプライトのバージョン識別子。 -
Blob: スプライトシートまたは JSON オフセットファイルの本文が含まれます。
