ガイドAPIリファレンス
ガイド
  1. HERE Routing API V8 - 開発者ガイド
  2. ルートのカスタマイズ

ルーティングからテリトリーを除外する方法

exclude[countries]およびexclude[states]パラメーターを使用すると、ルート検索から特定のテリトリーを除外するルートを計算できます。 これらのパラメーターを使用することで、ルートが指定した州や国を通過しないようにします。

たとえば、ルートのoriginまたはdestinationが除外されたテリトリーにある場合、ルート計算は失敗します。

国を除外する

この例では、ルート計算リクエストでexclude[countries]パラメーターを使用し、スイスをルート計算から除外しています。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=45.474427,9.138537&'\
'destination=50.096988,8.66033&'\
'return=polyline&'\
'transportMode=car&'\
'exclude[countries]=CHE&'\
'apiKey=YOUR_API_KEY'

青色のルートは、指定されたサンプルリクエストに従ってスイスを除外したルートを示しています。 紫色のルートは、exclude[countries]=CHEを使用してスイスを除外しなかった場合に、APIが計算したルートを示しています。

スイスを除外したルート

州を除外する

exclude[states]パラメーターを使用すると、テリトリーをより詳細なレベルで除外できます。 州の除外は、一部の国でしかサポートされていません。 完全なリストについては、「州の除外をサポートする国」を参照してください。

この例では、トゥクムカリからオクラホマシティへのルート計算リクエストで、テキサス州を除外しています。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=35.171888,-103.724999&'\
'destination=35.46546193,-97.52597214&'\
'return=polyline&'\
'transportMode=car&'\
'exclude[states]=USA:TX&'\
'apiKey=YOUR_API_KEY'

紫色のルートは、指定されたサンプルリクエストに従ってテキサスを除外したルートを示しています。 青色のルートは、exclude[states]=USA:TXを使用してテキサスを除外しなかった場合に、APIが計算したルートを示しています。

テキサスを除外したルート

迂回路が利用できない場合

テリトリーを除外する場合、HERE Routing API v8はユーザーの除外設定を尊重した迂回路を確実に提供します。 ただし、APIが迂回路を計算する能力には制限があります。 その一例が、ポーランドを回避してベルリンからヴィリニュスまでのルートを計算する場合です。

このサンプルリクエストを実行すると、計算が失敗することが確認できます。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.494438,13.40415&'\
'destination=54.679577,25.254137&'\
'return=polyline&'\
'transportMode=car&'\
'exclude[countries]=POL&'\
'apiKey=YOUR_API_KEY'

次のステップ

  • excludeパラメーターの使用方法の詳細については、「APIリファレンス」を参照してください。
  • ルート検索における回避については、「回避設定」を参照してください。これは、テリトリーの除外よりも制約が緩やかです。

先月の更新