【Advent Calendar 2022】投稿アイディア：カーナビ経路検索API　無料デモサイトで自由研究、英語力もアップ？

Advent Calendar 2022の投稿テーマはもう決まったでしょうか？

[HERE](https://www.here.com/) は、2022年の今年、:santa_tone2:サンタさんにプレゼント:gift:を届けていただけるようにお願いして、記事を募集しています！ 

https://qiita.com/advent-calendar/2022/here 

もし、
まだ投稿テーマが決まっていないようでしたら、
[HERE Routing API](https://www.here.com/platform/routing) について、[デモサイト](https://demo.routing.ext.here.com/)を利用して、いろいろ試してみた結果などを投稿してみませんか？

普段利用しているスマホやカーナビ地図上の経路検索を支えるAPIを無料のデモサイトで実際に触れながら試すことができます。
少し英語のドキュメントを確認する必要もあるかもしれませんが、参考となる情報を下記にご紹介致しますので、投稿アイディアとしてお試しいただければ幸いです！:blush:

# [HERE Routing (ルーティング)](https://www.here.com/platform/routing) について

https://www.here.com/platform/routing

HERE Routingは、移動経路（ルート）を計算し案内するサービスで、日本を含む世界複数の地域で提供されています。
その中でも、[HERE Routing API](https://jp.developer.here.com/documentation/routing-api/dev_guide/index.html) は、2つ以上の地点を間のルートを計算するための HTTP JSON REST API です。ルートの計算に影響を与える自動車、徒歩、トラック、自転車、バイクなどの移動手段はもちろん、様々なオプションを指定することが可能です。

## HEREのデモサイトについて
HERE は、位置情報テクノロジープラットフォーム企業として、創業以来35年以上、世界中の企業やデベロッパーと位置情報に関する課題解決に取り組んでます。

数多くの技術情報やDemoサイトも提供しておるのですが、日本語による案内がないため国内であまり知られておらず、、、以前、代表的なデモサイトをQiitaでも紹介しております。

https://qiita.com/kekomat/items/b381f134cd1faf5b156c

その中から[HERE Routing API Reference Demo](https://demo.routing.ext.here.com/)を今回ご活用いただきたいと思ってます。

## HERE Routing API Demo クイックスタート

https://demo.routing.ext.here.com/

https://demo.routing.ext.here.com/
に初めてアクセスいただくと、ドイツ:flag_de:ベルリン付近の地図が表示されるとおもいますが、ズームやスクロールしていただき、日本:flag_jp:まで移動してください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2725955/9a79a14c-1ee9-2e53-5169-f54013c259be.png)
右下の菱型のアイコン`Map Tiles`をクリックすると
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2725955/26bd5a72-0a69-19da-b2f1-1d94c9a0a3c3.png" width=50%>
設定変更パネルが開きます。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2725955/76cba9f3-33f7-0f59-9e33-395a74bbc76f.png" width=50%>
例えば、
その中の `STYLE URL` を `/oslo/japan/normal.day` が含まれたものにしていただくと、日本の方が見慣れたデザインの地図に表示が変更できたりします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2725955/a23bcec9-8aaa-6efd-0480-b15551fa1fe9.png)

また、 `Raster tile` を選択いただくと、選択項目が変更となり、例えば `STYLE` を `tko.hybrid.day` にしていただくと、衛星画像と地図の重ね合わせた画像を表示できたりします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2725955/e386627d-3e7d-49d3-524a-dba4a4014b1a.png)
日本だけではなく、世界中表示できますのでぐりぐり触って、地域によってのコンテンツの差などをご確認、お試しいただければと思います。

## ルート検索の例

地図中で、右クリックいただくと`Route From`、`To`のような項目が選択できますので、地図中にプロットいただき右下の`Send`ボタンを押下いただくとRouting APIがコールされルート検索結果が表示できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2725955/46dc9e9d-cd0c-8042-1276-17b85fe5710d.png)

サイドパネルで、各種パラメータを設定することもでき、丸印`（i）`をクリックいただくとパラメータの説明なども出てきますので、APIを実装する前の調査や検討にも活用いただけると思います。（英語情報だけでごめんなさい。。。）
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2725955/808ea5e3-e4ca-e0ba-5a81-63b216287b92.png" width=50%>


APIの詳細については、[HERE Routing API 開発ガイド](https://jp.developer.here.com/documentation/routing-api/dev_guide/index.html)英語版:flag_gb:をご覧ください。
ガイドのURL冒頭にjpを追加しますと、一部、[日本語機械翻訳](https://jp.developer.here.com/documentation/routing-api/dev_guide/index.html
):flag_jp:も提供しております。ご活用ください。
（日本語が美しくない部分、随時修正をしております。。。コッソリご連絡いただければ幸いです。。。:sweat:）

## [Transport modes(輸送モード)](https://developer.here.com/documentation/routing-api/dev_guide/topics/transport-modes.html)の紹介
乗用車、トラック、スクーターなど利用する交通手段に関連する規則や制限を考慮したルートを作成できます。
たとえば、自動車専用の高速道路、一方通行、歩行者専用のエリアなどの交通規制があります。

右下にある`Track Restrictions`アイコンを押していただくと、高さ制限などトラックのルート作成に利用される規制情報が表示されます。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2725955/d1907348-fb78-4912-b219-f59d6b7c7c64.png" width=50%>
制限事項のデータは、国や地域によって[整備されているレベル](https://developer.here.com/documentation/routing-api/dev_guide/topics/coverage/navigable-countries.html)が異なってますので、いろいろなエリアでご確認いただければと思います。
下記アメリカ シアトルエリアの例ですが、交通標識もアメリカのものが表示され個人的には世界各国の標識を見るだけでも楽しかったりします。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2725955/df1a7aef-44ab-7201-ee08-34f9a345938a.png" width=50%>


これら規制情報と車両の大きさやユーザー指定オプションを組み合わせ計算することで、[トラックのルート検索](https://jp.developer.here.com/documentation/routing-api/dev_guide/topics/truck-routing/truck-routing.html)ができます。左側のパネルで、`Transport` を `TRUCK` にしていただきお試しください。
<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2725955/2dcdbea3-4029-7dee-fdd8-efdcd895fbfc.png" width=50%>

また、Car（乗用車）モードの際に、
`Include EV parameters` をセットすることで、バッテリ容量や電費など電気自動車特有の情報を加味した[EVルーティング](https://jp.developer.here.com/documentation/routing-api/dev_guide/topics/use-cases/ev-routing.html)ができます。
下記は、神奈川県から宮城県にドライブする場合の充電ステーションを経由したルート例です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2725955/5fd26619-5bf5-c06e-6233-32ee23222af9.png)

# まとめ
多くの機能の代表的な一部だけご紹介しました。紹介しきれない機能がこのデモサイトにはありますので、ぜひ多くの皆様に触っていただければ幸いです。
また、日本よりもデータ整備が先行しているエリアでのみご利用いただける機能もあります。データの[カバレッジ](https://developer.here.com/documentation/routing-api/dev_guide/topics/coverage/navigable-countries.html)が高いエリアでもお試しください。

この記事がきっかけで、HEREプラットフォームを触ってみた！投稿が :flag_jp: 日本から :globe_with_meridians: 世界に展開されていくこと:santa:サンタさんと共に楽しみにしています！

To develop the best maps and location experiences for people and businesses to navigate their world!

https://www.here.com/jp/learn/blog/qiita-advent-calendar-2022-here