地理空間 フィルタリング
この章では、地理空間 フィルタリングの例を示します。 詳細について は、「地理空間 フィルター」を参照してください。
フローまたは所在地を中心とした半径内のインシデントのリクエスト
地理空間フィルター in=circle:{latitude},{longitude};r={radius}
を使用して、場所の周囲の特定の半径内で /flow
または /incidents
をリクエストします。
たとえば、ドイツのベルリン周辺の半径 2000 メートル以内のフローを要求するには、次のように要求を送信します。
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"
同じ場所にインシデントをリクエストするには、次のリクエストを使用します。
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
をリクエストします。
たとえば、ドイツのベルリンのエリアでフローを要求するには、次のようにリクエストを送信します。
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"
同じ場所にインシデントをリクエストするには、次のリクエストを使用します。
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.1022829
が5010228
になります。 このような各整数は、セットABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_
から一連の文字に変換さ れます。そのため、ポリライン全体が最終的に、これらの文字のみで構成された文字列で表されます。
例 :
BFoz5xJ67i1B1B7PzIhaxL7Y
は、次のポリラインを表していますか。
50.1022829,8.6982122
50.1020076,8.6956695
50.1006313,8.6914960
50.0987800,8.6875156
詳細については、 Flexible ポリラインを参照してください。
経路内のフローを要求するには、次の手順を実行
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"
同じ経路でインシデントをリクエストするには、次の手順に従う
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"