Context Broker GEの非常に強力な機能の1つは、ジオロケーションのクエリを実行できることです。次の空間関係を使用してエンティティをクエリすることができます:

  • georel=near: ジオメトリへの近接性。これは次の修飾子をサポートしています。
    • maxDistance: 一致するエンティティを配置する必要がある最大距離をメートルで表します。
    • minDistance: 一致するエンティティを配置する必要がある最小距離をメートルで表します。
  • georel=coveredBy: 定義されたジオメトリによってカバーされます。
  • georel=intersects: 基準となるジオメトリと交差する。
  • georel=equals: ジオメトリと等しい。
  • georel=disjoint: ジオメトリと交差していない。

適切なテナントが指定されるように、ヘッダFiware-Service: tourguideをすべてのリクエストに追加する必要があります。

例えば、Vitoria-Gasteiz市の中心から13km以内のすべてのレストラン(GPS座標42.846718, -2.671635で識別される)をクエリするには、コンテキスト・コンシューマアプリケーションは次のクエリを使用します:

GET <cb_host>:<cb_port>/v2/entities?georel=near;maxDistance:13000&geometry=point&coords=42.846718,-2.671635

Vitoria-Gasteiz市内の定義されたゾーン内のすべてのレストランを検索するために、コンシューマプリケーションは次のクエリを使用します:

GET <cb_host>:<cb_port>/v2/entities?georel=coveredBy&geometry=polygon&coords=42.847476,-2.763969;42.826006,-2.743151;42.826485,-2.653740;42.867061,-2.630934;42.881801,-2.640617;42.867767,-2.726723;42.847476,-2.763969