ラベルの言語を設定する
langおよびlang2パラメーターを使用してマップラベルの言語を制御します。
HERE Raster Tile API は複数の言語をサポートしているため、世界中のユーザーにローカライズされた地図を提供できます。以下のシナリオは、言語設定の一般的なユースケースです。
- 多言語アプリ - 世界中の利用者に向けて、ユーザーが希望する言語で地図を表示する
- 旅行アプリ - 海外でのナビゲーション用に現地の言語と英語の音訳を表示する
- 地域プラットフォーム - ユーザーの位置情報やブラウザーの設定に基づいて地図をローカライズする
- アクセシビリティ - 読みやすくするために複数の文字体系でラベルを付ける
構文
次のスニペットは、langおよびlang2パラメーターを含むリクエストのサンプルを示しており、英語の音訳付きでヒンディー語のラベルを生成します。
GET https://maps.hereapi.com/v3/base/mc/12/2926/1707/png?lang=hi&lang2=en&apiKey={YOUR_API_KEY}説明:
lang- プライマリラベル言語(ISO 639-1コード)lang2- セカンダリラベル言語(ISO 639-1コード)
langおよびlang2パラメーターの許容値として使用できるのは、ISO 639-1言語コード(en、de、ja、zhなど)です。
利用可能な言語のリストをリクエストする
/languagesエンドポイントを使用して、リソースタイプごとにサポートされている言語のリストをクエリできます。
GET https://maps.hereapi.com/v3/languages?apiKey={YOUR_API_KEY}レスポンス例:
{"base":["ar","as","az","be","bg","bn","bs","ca","cs","cy","da","de","el","en","es","et","eu","fi","fo","fr","ga","gl","gn","gu","he","hi","hr","hu","hy","id","is","it","ja","ka","kk","km","kn","ko","ky","lt","lv","mk","ml","mr","ms","mt","my","nl","no","or","pa","pl","pt","ro","ru","sk","sl","sq","sr","sv","ta","te","th","tr","uk","uz","vi","zh","zh-Hant"]}注
You can cache this list in your application and refresh every 24 hours.
例
以下は、さまざまな言語設定がマップラベルにどのように影響するかを示す例です。言語パラメーターの設定が異なるマップリクエストのサンプルと、同じ地理的位置に対して得られた結果のタイルの例を紹介しています。言語オプションを変えることで、同じマップデータがどのように表示されるかを比較できます。
デフォルト言語
プライマリ言語もセカンダリ言語も明示的に指定されていない場合、次のリクエスト例に示すように、地図はデフォルトで現地言語になります。
GET https://maps.hereapi.com/v3/base/mc/12/2926/1707/png?size=512&apiKey={YOUR_API_KEY}
プライマリ言語(英語)
次の例は、プライマリ言語が英語(lang=en)に設定された地図を示しています。
GET https://maps.hereapi.com/v3/base/mc/12/2926/1707/png?size=512&lang=en&apiKey={YOUR_API_KEY}
プライマリ言語とセカンダリ言語
次の例は、プライマリ言語を英語(lang=en)、セカンダリ言語をヒンディー語(lang2=hi)に設定した地図を示しています。
GET https://maps.hereapi.com/v3/base/mc/12/2926/1707/png?size=512&lang=en&lang2=hi&apiKey={YOUR_API_KEY}
セカンダリ言語のみ
次の例は、セカンダリ言語のみを設定した場合(lang2=en)の地図を示しています。この場合、地図のプライマリ言語は常にデフォルトで現地言語になります。
GET https://maps.hereapi.com/v3/base/mc/12/2926/1707/png?size=512&lang2=en&apiKey={YOUR_API_KEY}
次のステップ
- ビジュアルテーマについて詳しくは、「スタイルを適用する」を参照してください。
- 地域固有の境界について詳しくは、「地政学的見解を尊重する」を参照してください。
- APIエンドポイントとリクエストパラメーターの詳細については、「APIリファレンス」を参照してください。
20 日前の更新