地理空間 フィルタリング

この章では、地理空間 フィルタリングの例を示します。 詳細について は、「地理空間 フィルター」を参照してください。

地理空間 のフィルタリングは、返されるアイテムに影響を与えますが、レスポンス形式は変更されません。 以下の例では、レスポンスデータは示されていません。 フローデータをリクエスト および インシデントデータをリクエストのレスポンスの例を参照してください。

フローまたは所在地を中心とした半径内のインシデントのリクエスト

地理空間フィルター in=circle:{latitude},{longitude};r={radius} を使用して、場所の周囲の特定の半径内で /flow または /incidentsをリクエストします。

たとえば、ドイツのベルリン周辺の半径 2000 メートル以内のフローを要求するには、次のように要求を送信します。

ベアラートークン
| apiKey
curl -H "Authorization: Bearer $TOKEN" "https://data.traffic.hereapi.com/v7/flow?in=circle:52.50811,13.47853;r=2000&locationReferencing=olr"
curl "https://data.traffic.hereapi.com/v7/flow?in=circle:52.50811,13.47853;r=2000&locationReferencing=olr&apiKey=$API_KEY"

同じ場所にインシデントをリクエストするには、次のリクエストを使用します。

ベアラートークン
| apiKey
curl -H "Authorization: Bearer $TOKEN" "https://data.traffic.hereapi.com/v7/incidents?in=circle:52.50811,13.47853;r=2000&locationReferencing=olr"
curl "https://data.traffic.hereapi.com/v7/incidents?in=circle:52.50811,13.47853;r=2000&locationReferencing=olr&apiKey=$API_KEY"

フローまたは四角形の領域内のインシデントのリクエスト

地理空間フィルター in=bbox:{west longitude},{south latitude},{east longitude},{north latitude}を使用して、長方形のBounding Box内の /flow または/incidentsをリクエストします。

たとえば、ドイツのベルリンのエリアでフローを要求するには、次のようにリクエストを送信します。

ベアラートークン
| apiKey
curl -H "Authorization: Bearer $TOKEN" "https://data.traffic.hereapi.com/v7/flow?in=bbox:13.386969,52.527129,13.424134,52.549420&locationReferencing=olr"
curl "https://data.traffic.hereapi.com/v7/flow?in=bbox:13.386969,52.527129,13.424134,52.549420&locationReferencing=olr&apiKey=$API_KEY"

同じ場所にインシデントをリクエストするには、次のリクエストを使用します。

ベアラートークン
| apiKey
curl -H "Authorization: Bearer $TOKEN" "https://data.traffic.hereapi.com/v7/incidents?in=bbox:13.386969,52.527129,13.424134,52.549420&locationReferencing=olr"
curl "https://data.traffic.hereapi.com/v7/incidents?in=bbox:13.386969,52.527129,13.424134,52.549420&locationReferencing=olr&apiKey=$API_KEY"

経路内のフローまたはインシデントのリクエスト

地理空間フィルタin=corridor:{polyline};r={radius}を使用して、特定の幅の経路内の /incidentsまたは/flowをリクエストします。

ポリラインは Flexible ポリライン で、Corridorのwaypointsを指定します。 半径によって、Waypointsの両側までのCorridorの距離がメートル単位で決まります。 つまり、半径が 230 メートルの場合、Corridorの幅は 460 メートルになります。

Flexible ポリラインは、緯度と経度のペアのリストを特別にエンコードしたものです。 各座標は整数に変換され、保持する小数点以下の桁数は精度で指定されます。 精度が 5 の場合、緯度 50.10228295010228になります。 このような各整数は、セットABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_から一連の文字に変換さ れます。そのため、ポリライン全体が最終的に、これらの文字のみで構成された文字列で表されます。

例 :

BFoz5xJ67i1B1B7PzIhaxL7Y は、次のポリラインを表していますか。

50.1022829,8.6982122
50.1020076,8.6956695
50.1006313,8.6914960
50.0987800,8.6875156

詳細については、 Flexible ポリラインを参照してください。

経路内のフローを要求するには、次の手順を実行

ベアラートークン
| apiKey
curl -H "Authorization: Bearer $TOKEN" "https://data.traffic.hereapi.com/v7/flow?in=corridor:BFoz5xJ67i1B1B7PzIhaxL7Y;r=230&locationReferencing=olr"
curl "https://data.traffic.hereapi.com/v7/flow?in=corridor:BFoz5xJ67i1B1B7PzIhaxL7Y;r=230&locationReferencing=olr&apiKey=$API_KEY"

同じ経路でインシデントをリクエストするには、次の手順に従う

ベアラートークン
| apiKey
curl -H "Authorization: Bearer $TOKEN" "https://data.traffic.hereapi.com/v7/incidents?in=corridor:BFoz5xJ67i1B1B7PzIhaxL7Y;r=230&locationReferencing=olr"
curl "https://data.traffic.hereapi.com/v7/incidents?in=corridor:BFoz5xJ67i1B1B7PzIhaxL7Y;r=230&locationReferencing=olr&apiKey=$API_KEY"

」に一致する結果は 件です

    」に一致する結果はありません