サポートされている言語
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 つの言語、つまりオーストラリア英語とスペイン語 (スペイン、マドリード) が指定されています。どちらもサポートされていません。 最も特殊なサポート対象言語はスペイン語 (スペイン) であるため、英語の代わりにこれが選択されると、上のようなレスポンスになります。
25 日前の更新