翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# グリフでラベルのスタイルを設定する
<a name="styling-labels-with-glyphs"></a>

グリフは、エンコードされた Unicode 文字を含むバイナリファイルで、ラベルを表示するためにマップレンダラーによって使用されます。Amazon Location Service を使用すると、`GetGlyphs` API を介したマップレンダリングで使用できるように、フォントスタックから特定のグリフを取得できます。

詳細については、「*Amazon Location Service API リファレンス*」の「[GetGlyphs](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetGlyphs.html)」を参照してください。

## ユースケース
<a name="glyphs-use-cases"></a>
+ 特定のフォントとスタイルのマップでカスタムテキストをレンダリングします。
+ ローカライズされたマップテキストレンダリングのグリフを取得します。
+ Unicode 文字範囲を使用してマップラベルと記号を表示します。
+ フォントスタックとグリフ範囲に基づいてマップフォントレンダリングを最適化します。

## API でサポートされているフォント
<a name="supported-fonts"></a>

API では、以下のフォントがサポートされています。
+ Amazon Ember Bold
+ Amazon Ember Bold Italic
+ Amazon Ember Bold、Noto Sans Bold
+ Amazon Ember Bold、Noto Sans Bold、Noto Sans Arabic Bold
+ Amazon Ember Condensed RC BdItalic
+ Amazon Ember Condensed RC Bold
+ Amazon Ember Condensed RC Bold Italic
+ Amazon Ember Condensed RC Bold、Noto Sans Bold
+ Amazon Ember Condensed RC Bold、Noto Sans Bold、Noto Sans Arabic Condensed Bold
+ Amazon Ember Condensed RC Light
+ Amazon Ember Condensed RC Light Italic
+ Amazon Ember Condensed RC LtItalic
+ Amazon Ember Condensed RC Regular
+ Amazon Ember Condensed RC Regular Italic
+ Amazon Ember Condensed RC Regular、Noto Sans Regular
+ Amazon Ember Condensed RC Regular、Noto Sans Regular、Noto Sans Arabic Condensed Regular
+ Amazon Ember Condensed RC RgItalic
+ Amazon Ember Condensed RC ThItalic
+ Amazon Ember Condensed RC Thin
+ Amazon Ember Condensed RC Thin Italic
+ Amazon Ember Heavy
+ Amazon Ember Heavy Italic
+ Amazon Ember Light
+ Amazon Ember Light Italic
+ Amazon Ember Medium
+ Amazon Ember Medium Italic
+ Amazon Ember Medium、Noto Sans Medium
+ Amazon Ember Medium、Noto Sans Medium、Noto Sans Arabic Medium
+ Amazon Ember Regular
+ Amazon Ember Regular Italic
+ Amazon Ember Regular Italic、Noto Sans Italic
+ Amazon Ember Regular Italic、Noto Sans Italic、Noto Sans Arabic Regular
+ Amazon Ember Regular、Noto Sans Regular
+ Amazon Ember Regular、Noto Sans Regular、Noto Sans Arabic Regular
+ Amazon Ember Thin
+ Amazon Ember Thin Italic
+ AmazonEmberCdRC\$1Bd
+ AmazonEmberCdRC\$1BdIt
+ AmazonEmberCdRC\$1Lt
+ AmazonEmberCdRC\$1LtIt
+ AmazonEmberCdRC\$1Rg
+ AmazonEmberCdRC\$1RgIt
+ AmazonEmberCdRC\$1Th
+ AmazonEmberCdRC\$1ThIt
+ AmazonEmber\$1Bd
+ AmazonEmber\$1BdIt
+ AmazonEmber\$1He
+ AmazonEmber\$1HeIt
+ AmazonEmber\$1Lt
+ AmazonEmber\$1LtIt
+ AmazonEmber\$1Md
+ AmazonEmber\$1MdIt
+ AmazonEmber\$1Rg
+ AmazonEmber\$1RgIt
+ AmazonEmber\$1Th
+ AmazonEmber\$1ThIt
+ Noto Sans Black
+ Noto Sans Black Italic
+ Noto Sans Bold
+ Noto Sans Italic
+ Noto Sans Extra Bold
+ Noto Sans Extra Bold Italic
+ Noto Sans Extra Light
+ Noto Sans Extra Light Italic
+ Noto Sans Italic
+ Noto Sans Light
+ Noto Sans Light Italic
+ Noto Sans Medium
+ Noto Sans Medium Italic
+ Noto Sans Regular
+ Noto Sans Semi Bold
+ Noto Sans Semi Bold Italic
+ Noto Sans Thin
+ Noto Sans Italic
+ NotoSans-Bold
+ NotoSans-Italic
+ NotoSans-Medium
+ NotoSans-Regular
+ Open Sans Regular,Arial Unicode MS Regular

## リクエストを理解する
<a name="glyphs-understand-the-request"></a>

リクエストは、グリフのフォントと Unicode 範囲を決定する `FontStack`と `FontUnicodeRange` の 2 つの必須 URI パラメータを受け入れます。`FontStack` パラメータは使用するフォントを指定し、`FontUnicodeRange` は取得する文字範囲を定義します。リクエストには本文が含まれず、その機能の URI パラメータのみに焦点を当てます。
+ **`FontStack`**: 取得するフォントスタックの名前を指定します。例: 「Amazon Ember Bold, Noto Sans Bold」
+ **`FontUnicodeRange`**: グリフをダウンロードする Unicode の文字範囲。範囲は 256 の倍数にする必要があります。例: 「0-255」

## レスポンスを理解する
<a name="glyphs-understand-the-response"></a>

レスポンスは、キャッシュ用の HTTP ヘッダー、コンテンツタイプ、ETag、料金情報と共に、グリフデータをバイナリブロブとして返します。グリフデータは、マップにレンダリングされるバイナリブロブとして返され、ヘッダーはレスポンスを効果的に処理するための追加のメタデータを提供します。
+ **`CacheControl`**: レスポンスのキャッシュ設定をクライアントに指示します。
+ **`ContentType`**: 返されるグリフデータのタイプを示すレスポンス本文の形式を指定します。
+ **`ETag`**: キャッシュ検証に使用されるグリフのバージョン識別子。
+ **`PricingBucket`**: リクエストに関連付けられた料金階層を示します。
+ **`Blob`**: マップテキストのレンダリングに使用され、バイナリブロブとして返されるグリフデータ。