スプライトを使用したアイコノグラフィーのスタイル

スプライトは、マップ上にレンダリングされたアイコン、マーカー、その他の要素などの小さなラスターイメージを含むポータブルネットワークグラフィック (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 オフセットファイルの本文が含まれます。

Standard Light

Standard Dark

Monochrome Light

Monochrome Dark

Hybrid