ガイドAPIリファレンス
ガイド

サポートされている言語

Routing API v8は、ローカリゼーションまたは指示の生成用に次の言語をサポートしています。

言語言語コード
アフリカーンス語    af
アルバニア語    sq
アムハラ語    am
アラビア語 (サウジアラビア)    ar、ar-sa
アルメニア語    hy
アッサム語    as
アゼルバイジャン語 (ラテン)    az、az-Latn
バングラ語 (バングラデシュ)    bn、bn-bd
バングラ語 (インド)    bn-in
バスク語    eu
ベラルーシ語    be
ボスニア語    bs
ブルガリア語    bg
カタルーニャ語    ca
カタロニア語(スペイン)    ca-ES
中国語(簡体字、中国)    zh、zh-cn
中国語 (繁体字、香港特別行政区)    zh-hk
中国語 (繁体字、台湾)    zh-tw
クロアチア語    hr
チェコ語 (チェコ共和国)    cs、cs-cz
デンマーク語 (デンマーク)    da、da-dk
ダリ語    prs、prs-Arab
オランダ語 (オランダ)    nl、nl-nl
英語 (英国)    en-gb
英語 (米国)    en、en-us
エストニア語    et
フィリピン語    fil、fil-Latn
フィンランド語 (フィンランド)    fi、fi-FI
フランス語 (フランス)    fr、fr-FR
ガリシア語    gl
グルジア語    ka
ドイツ語 (ドイツ)    de、de-de
ギリシャ語 (ギリシャ)    el、el-gr
グジャラート語    gu
ハウサ語    ha、ha-Latn
ヘブライ語 (イスラエル)    he、he-IL
ヒンディー語 (インド)    hi、hi-IN
ハンガリー語 (ハンガリー)    hu、hu-hu
アイスランド語    is
イボ語    ig、ig-Latn
インドネシア語 (インドネシア)    id、id-ID
アイルランド語    ga
イタリア語 (イタリア)    it、it-IT
日本語 (日本)    ja、ja-jp
カンナダ語    kn
カザフ語    kk
クメール語    km
ルワンダ語 (ルワンダ)    rw、rw-RW
コンカニ語    kok
韓国語 (韓国)    ko、ko-KR
クルド語    ku、ku-Arab
キルギス語    ky、ky-Cyrl
キチェ語    quc、quc-Latn
ラトビア語    lv
リトアニア語    lt
ルクセンブルク語    lb
マケドニア語    mk
マレー語 (マレーシア)    ms、ms-MY
マラヤーラム語    ml
マルタ語    mt
マラティ語    mr
モンゴル語    mn、mn-Cyrl
マオリ語    mi、mi-Latn
ネパール語 (ネパール)    ne、ne-NP
北ソト語    nso
ノルウェー語 (ブークモール)    nb、no
ノルウェー語 (ニーノシュク)    nn
オディア語    or
ペルシア語    fa
ポーランド語 (ポーランド)    pl、pl-pl
ポルトガル語 (ブラジル)    pt-BR
ポルトガル語 (ポルトガル)    pt、pt-pt
パンジャーブ語    pa
パンジャーブ語 (アラビア文字)    pa-Arab
ケチュア語 (ペルー)    quz、quz-Latn-PE
ルーマニア語 (ルーマニア)    ro、ro-ro
ロシア語 (ロシア)    ru、ru-ru
スコットランド・ゲール語    gd、gd-Latn
セルビア語 (キリル文字、ボスニア・ヘルツェゴビナ)    sr-Cyrl-BA
セルビア語 (キリル文字、セルビア)    sr-Cyrl-RS
セルビア語 (ラテン文字、セルビア)    sr、sr-Latn-RS
シンド語 (アラビア文字)    sd、sd-Arab
シンハラ語    si
スロバキア語 (スロバキア)    sk、sk-sk
スロベニア語 (スロベニア)    sl、sl-si
スペイン語 (スペイン)    es、es-es
スワヒリ語    sw
スウェーデン語 (スウェーデン)    sv、sv-SE
タジク語    tg-Cyrl
タミル語    ta
タタール語    tt、tt-Cyrl
テルグ語    te
タイ語 (タイ)    th、th-TH
ティグリニャ語    ti
ツワナ語    tn
トルコ語 (トルコ)    tr、tr-TR
トルクメン語    tk、tk-Latn
ウクライナ語    uk
ウルドゥー語    ur
ウイグル語    ug、ug-Arab
ウズベク語 (キリル文字)    uz、uz-Cyrl
ベトナム語    vi
ウェールズ語    cy
ウォロフ語    wo、wo-Latn
コサ語    xh
ヨルバ語    yo、yo-Latn
ズールー語 (南アフリカ)    zu、zu-ZA

代替言語のフォールバック解決

Routing API v8では、メイン言語が使用できない場合に試行する1つ以上の代替言語を呼び出し元が指定できます。 次のリクエストの例を考えてみましょう

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'transportMode=car&'\
'origin=52.5308,13.3847&'\
'destination=52.5264,13.3686&'\
'return=summary,polyline,actions,instructions&'\
'lang=fake-lang,es-es,sr-Latn&'\
'apiKey=YOUR_API_KEY'

メイン言語の fake-lang が使用できないため、API は利用可能な言語に当たるまで後続の言語を使って試行します。この場合は es-es です。 利用可能な言語がない場合、言語はデフォルトで en-us になります。

また、言語の解決はもう少し複雑になることもあります。あきらめる前に、サービスは言語を一般化し、適切な代替言語を見つけようとします。 たとえば、使用できない言語であるラテンアメリカのスペイン語 (es-419) をリクエストした場合にどうなるか見てみましょう。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'transportMode=car&'\
'origin=52.5308,13.3847&'\
'destination=52.5264,13.3686&'\
'return=summary,polyline,actions,instructions&'\
'lang=es-419&'\
'apiKey=YOUR_API_KEY'

レスポンスはクエリが失敗していないことを示しています。 代わりに、言語は es-419 によく似た es-es に戻り、デフォルトの en-us には戻りません。 さらに、レスポンスには、言語の置換が行われたことを知らせる通知が含まれます。

{
  "notices": [
    {
      "code": "mainLanguageNotFound",
      "severity": "info",
      "title": "Couldn't find the main language"
    }
  ],
  "routes": [
    {
      "sections": [
        {
          ...,
          "actions": [
            {
              "action": "depart",
              "duration": 133,
              "instruction": "Diríjase a Chausseestraße por Invalidenstraße. Siga durante 1.2 km.",
              "length": 1206,
              "offset": 0
            },
            {
              "action": "arrive",
              "duration": 0,
              "instruction": "Ha llegado a Invalidenstraße. Su destino está a la derecha.",
              "length": 0,
              "offset": 45
            }
          ],
          "language": "es-es",
          ...
        }
      ]
    }
  ]
}

複数の言語がフォールバックとして含まれている可能性がある場合、より一般的な置換の検索も行われます。 ただし、言語の優先順位は言語リストの順序よりも優先されます。 つまり、リスト上の第 1 言語と第 2 言語に適切な一般化が利用可能であっても、第 2 言語のものの方がより具体的な場合は、第 2 言語のものよりも優先されます。 次の例を考えてみましょう。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'transportMode=car&'\
'origin=52.5308,13.3847&'\
'destination=52.5264,13.3686&'\
'return=summary,polyline,actions,instructions&'\
'lang=en-au,es-es-madrid&'\
'apiKey=YOUR_API_KEY'

リクエストでは、サポートされていない 2 つの言語、つまりオーストラリア英語とスペイン語 (スペイン、マドリード) が指定されています。どちらもサポートされていません。 最も特殊なサポート対象言語はスペイン語 (スペイン) であるため、英語の代わりにこれが選択されると、上のようなレスポンスになります。