ルートデータの優先言語を指定する

このチュートリアルでは、ルートデータの言語設定に影響を与える方法を説明します。

lang パラメーターをサポートされている言語のいずれかに設定して、言語設定を指定します。デフォルト値は en-US です。

ルートレスポンス内の言語固有の属性ごとに、ルート検索サービスはユーザーの設定を利用可能な言語と照合します。完全に一致するものがない場合、サービスは最善の照合結果を選択します。

langパラメーターは、結果のルートのいくつかの要素に影響します。

names、routeNumbers：これらの属性の場合、言語のマッチングではローカル言語の設定も考慮されます。返される値は、上位の項目が最適な言語になるように並べ替えられます。
instruction：アクションの指示は最適な言語に翻訳されます。道路の名前が指示に含まれている場合でも、その道路の名前が指示と同じ言語とは限りません。

ブリュッセルでは、オランダ語の道路名がフランス語の道路名より優先され、道路に英語の名前はありません。

これは、lang=fr-frを使用してブリュッセルのルートを計算するリクエストです。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=50.842087,4.375136&'\
'destination=50.842176,4.375498&'\
'return=actions,instructions,polyline&'\
'spans=names,routeNumbers&'\
'transportMode=car&'\
'lang=fr-fr&'\
'apiKey=YOUR_API_KEY'

レスポンスでは、まずRue de Toulouseを並べ替え、それをフランス語のinstructionで使用します。

"actions": [
  {
    "instruction": "Dirigez-vous vers le Nord-Est sur Rue de Toulouse. Continuez pendant 27 m.",
    ...
  },
  {...}
],
"spans": [
  {
    "offset": 0,
    "names": [
      {
        "value": "Rue de Toulouse",
        "language": "fr"
      },
      {
        "value": "Toulousestraat",
        "language": "nl"
      }
    ]
  }
],
"language": "fr-FR"

このリクエストは、リクエストされた言語を lang=en-US に変更します。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=50.842087,4.375136&'\
'destination=50.842176,4.375498&'\
'return=actions,instructions,polyline&'\
'spans=names,routeNumbers&'\
'transportMode=car&'\
'lang=end-US&'\
'apiKey=YOUR_API_KEY'

英語の道路名は利用できませんが、ローカル設定では Toulousestraat が優先されます。これは最初に names で表示され、英語の instruction で使用されます。

"actions": [
  {
    "instruction": "Head northeast on Toulousestraat. Go for 27 m.",
    ...
  },
  {...}
],
"spans": [
  {
    "offset": 0,
    "names": [
      {
        "value": "Toulousestraat",
        "language": "nl"
      },
      {
        "value": "Rue de Toulouse",
        "language": "fr"
      }
    ]
  }
],
"language": "en-us"

25 日前の更新