ジオフェンスの近接度と検索半径がアセットの距離に与える影響

HERE Geofencing APIは、アセットの位置をカバーするポリゴンジオフェンス、またはアセットの周辺のポリゴンジオフェンスごとに、ジオフェンスジオメトリーと、アセットからこのジオメトリーまでの距離を返します。

アセットの距離は次の要因の影響を受ける場合があります。

アセットがジオフェンスの外側にある。ジオフェンスの最も近い境界までの距離が直線で測定されている。ラインジオフェンスとポイントジオフェンスの場合は常にこのように算出されます。
アセットがジオフェンス内にある。ポリゴンの最も近い境界までの距離が直線で測定されている。値が負の数である。
アセットが探索半径の外側にある。ジオフェンスがレスポンスにリストされていない。
アセットがポリゴンの内側にあるものの、探索半径の境界から離れている。「内側の離れた場所」であることを示す特別な値が返されます。

アプリでは、アセットの距離を使用して、特定の距離のしきい値に基づき異なる重大度レベルのイベントを生成できます。アセットがジオフェンスの境界に沿って移動している場合、およびアセットの距離が大幅に変わることなくジオフェンス内に頻繁に出入りしている場合、不要なイベントを生成しないようにすることができます。

パフォーマンス維持のため、アセットの距離は直線距離のみで示され、走行距離または走行時間に対応する値ではありません。アセットの距離は約20キロメートルが上限であるため、距離は次のいずれかになります。

最も近い境界から250mのポリゴンの内側
最も近い境界から20km超離れたポリゴンの内側
最も近い境界から333mのジオフェンスの外側
最も近い境界から20km超離れたジオフェンスの外側 (アセットが探索半径の外側にある場合、この値は一覧に含まれないすべてのジオフェンスに適用されます)

ジオフェンスへの出入り、ジオフェンスの境界周辺での移動、ジオフェンスへの繰り返しの侵入などのイベントの場合、明示的なレスポンスは受け取らず、アセットの距離のみ受け取ります。同じことがひと続きのイベントにも適用されます。たとえば、同日にアセットがジオフェンスに入ったのが3回目の場合やジオフェンスを出たのが2回目の場合などです。

📘
注
HERE Geofencing API v8ではアセットの識別または登録は必須ではなく、サポートもしていません。