屋内ルート検索サービス

このチュートリアルでは屋内ルート検索サービスの概要と、APIを使用して利用する方法について説明します。

屋内ルート検索サービスは、ショッピングモール、駐車場、空港、オフィス、病院などの屋内施設の屋内マップ内でルートを生成する機能を提供します。屋内の属性を考慮しながら、屋内マップ内の複数のフロアにまたがるルートを生成できます。また、車両のみのルートや、車両と歩行者を組み合わせたルートなど、マルチモーダルルートもリクエストできます。

前提条件

組織がHERE Indoor Mapにオンボーディングされている必要があります。詳細については、「屋内地図の使用準備をする」を参照してください。
建物向けのHERE Indoor Mapを注文し、ルート検索グラフを選択する必要があります。詳細については、「屋内地図を注文し更新する」を参照してください。
屋内ルート検索サービスを使用するユーザーまたはアプリを、屋内地図プロジェクトのメンバーとして追加します。屋内地図プロジェクトにユーザーを追加する方法については、「屋内地図プロジェクトに新しいユーザーを追加する」を参照してください。

屋内ルート検索APIリファレンス

APIリファレンス

機能とツール

複数のフロアにまたがるルートの計算。
ルート計算時にスペースアドレッシング (特定の空間の中心点) を考慮。
トポロジーmodalityおよびdirectionalityに基づくルート計算。
サポートされる移動モード：pedestrian、car、taxi、scooter。
ルートの空き状況に応じて、歩行者の有無にかかわらず一度に1台の車両のみが通行するマルチモーダルルート。TransportModeでは1つの値のみを想定していますが、車両モードが指定された場合、pedestrianはデフォルトではセカンダリモードと見なされます。
ユーザーがパラメーターでvehicle-enableのオプションを指定し、start、endまたは車両によるentireのジャーニーを希望する場合は、カスタマイズされたルートとなります。
定義された範囲で任意の移動モードに対するカスタマイズされたspeedのオプションです。指定された速度に基づいて時間が計算されます。
ユーザーがリクエストしたルート条件のいずれかが満たされない場合、noticeがユーザーに提示されます。たとえば、ユーザーが車でのルートをリクエストしたものの、そのようなルートが存在しないか利用できない場合、歩行者向けのルート案内から始まり、最終的に車でのルートに移行する同等のルートが提示され、出力ルートで指定された条件が満たされていないことを警告する通知が表示されます。
APIにクエリパラメーターを指定し、要件 (ルートに階段、エスカレーター、スロープなどのavoidフィーチャーが必要かどうかなど) に基づいてルートを計算
ルート検索モードを、パラメーター (fastまたはshort) として指定可能。fastは所要時間が最短となるルートを返し、shortは距離が最短となるルートを返します。
実際の出発地と目的地の間に1つ以上のvia経由地パラメーターを指定することにより、追加の中間経由地をルートに挿入できます。ルートは指定された順序でそれらの場所を訪れます。