ジオフェンス内にアセットがあるかを確認する方法

アセットが位置するジオフェンスポリゴンと、そのポリゴンからの距離を確認できます。

以下の例では、inパラメーターはアセットのGPS位置 (緯度および経度) を表しています。

https://geofencing.hereapi.com/v8/geofence?
apikey={YOUR_API_KEY}
&in=point:50.09960669260986,8.67125687487836;r=15000
&layers=MYTESTLAYER2

📘
注
この例ではHERE APIキーを使用してリクエストを認証しています。使用可能な認証オプションについては、Identity & Access Management開発者ガイドを参照してください。

レスポンス

リクエストのレスポンスには、アセットの位置を構成する各ジオメトリーに関する情報、またはアセットの位置から指定された探索半径以内の各ジオメトリーに関する情報が含まれます。

{
    "geometries": [
        {
            "attributes": {
                "ID": "1",
                "GEOMETRY_ID": "0",
                "NAME": "Frankfurt2",
                "ABBR": "FRAN"
            },
            "distance": -15.58,
            "nearestLat": 50.09949,
            "nearestLon": 8.67113,
            "originalLat": 50.09960669260986,
            "originalLon": 8.67125687487836,
            "layerId": "MYTESTLAYER2",
            "geometry": "MULTIPOLYGON(((8.67029 50.09987,8.67192 50.10048,8.67294 50.09966,8.67217 50.09903,8.67176 50.09921,8.67176 50.09921,8.67029 50.09987)))"
        }
    ],
    "meta": [
        {
            "layerId": "MYTESTLAYER2",
            "lastUpdateTimeStamp": 1730911589834
        }
    ]
}

次の例はカスタムオブジェクトに対する (POSTリクエスト経由での) マルチポイント検索の仕組みを示しています。

https://geofencing.hereapi.com/v8/geofence?
apikey={YOUR_API_KEY}
&in=assetPositions
&filter=NAME='Frankfurt2'
{
"point": [
{
	"lat": 50.09960669260986,
	"lon": 8.67125687487836,
	"layer": "MYTESTLAYER2",
	"searchRadius": 15000
}
	]
}

レスポンス：

{
    "geometries": [
        {
            "attributes": {
                "ID": "1",
                "GEOMETRY_ID": "0",
                "NAME": "Frankfurt2",
                "ABBR": "FRAN"
            },
            "distance": -15.58,
            "nearestLat": 50.09949,
            "nearestLon": 8.67113,
            "originalLat": 50.09960669260986,
            "originalLon": 8.67125687487836,
            "layerId": "MYTESTLAYER2",
            "geometry": "MULTIPOLYGON(((8.67029 50.09987,8.67192 50.10048,8.67294 50.09966,8.67217 50.09903,8.67176 50.09921,8.67176 50.09921,8.67029 50.09987)))"
        }
    ],
    "meta": [
        {
            "layerId": "MYTESTLAYER2",
            "lastUpdateTimeStamp": 1730911589834
        }
    ]
}

アセットに識別子を追加する

オプションのパラメーターassetIDを使用してアセットアロケーションを強化します。サンプルリクエストでは、1111のassetIdをリクエストされたジオフェンスに割り当てます。

https://geofencing.hereapi.com/v8/geofence?
apikey={YOUR_API_KEY}
&in=point:50.09960669260986,8.67125687487836;r=15000
&layers=MYTESTLAYER2
&assetId=1111

APIレスポンスには、リクエストに含まれる各アセットに割り当てられたassetIdが含まれます。

{
    "geometries": [
        {
            "attributes": {
                "ID": "1",
                "GEOMETRY_ID": "0",
                "NAME": "Frankfurt2",
                "ABBR": "FRAN"
            },
            "distance": -15.58,
            "nearestLat": 50.09949,
            "nearestLon": 8.67113,
            "originalLat": 50.09960669260986,
            "originalLon": 8.67125687487836,
            "layerId": "MYTESTLAYER2",
            "geometry": "MULTIPOLYGON(((8.67029 50.09987,8.67192 50.10048,8.67294 50.09966,8.67217 50.09903,8.67176 50.09921,8.67176 50.09921,8.67029 50.09987)))",
            "assetId": "1111"
        }
    ],
    "meta": [
        {
            "layerId": "MYTESTLAYER2",
            "lastUpdateTimeStamp": 1730911589834
        }
    ]
}

レスポンス

アセットに識別子を追加する

関連情報