カスタム位置情報拡張 2.

レイヤーとフィルタリング

すべてのデータがレイヤーの形式で整理されます。 情報をアップロード、保存、または検索する場合、レイヤー名の文字列が指定され、関連する情報をより適切にフィルタリングするために使用できます。

形状の属性を確認することで、さらにフィルタリングできます。 これらの属性は、などのジオメトリにリンクされたユーザー定義のフィールド CLE2PointGeometryで、テキストフィールドまたは数値フィールドにすることができます。

データの挿入とアップロード

To upload data to the CLE2 servers, you can use the web interface or REST APIs. Refer to the following User Guide for more details: https://here-tech.skawa.fun/documentation .

SDK for Android を使用して、ローカルおよびサーバーにデータを挿入することもできます。 HERE SDK を使用すると、ローカルでオフラインで保存している場合でも、場所を参照するデータを簡単に生成できます。また、接続が確立されたときに、その情報を順次他のデバイスに共有できます。

空間検索を実行しています

検索を実行するには、次のように検索タイプのいずれかを選択します。 すべてのリクエストに共通の入力パラメータは、レイヤー名です。

各検索リクエストタイプでは、次に示すような共通のパラメータがサポートされています。

検索リクエストオブジェクトを作成し、必要に応じて設定したら execute(CLE2ResultListener) 、そのメソッドを呼び出します。 検索の結果が、指定されたリスナーに配信されます。 CLE2Result を呼び出し getGeometries()て、検索条件に一致するジオメトリをオブジェクトから取得できます。 この形状結果のリストには、次のタイプのオブジェクトが含まれている可能性があります。

OpenGIS ( 地理情報の実装標準 ) および WKT 表現形式では、ポリゴンの概念は、 1 つの外側のリングポリゴンに 0 個以上の内側の穴のポリゴンを加えたもので定義されます。 CLE2PolygonGeometry このため、クラスに GeoPolygon はとセカンダリ GeoPolygon アレイが含まれています。

ローカルおよび完全な検索結果について

ユーザーがアップロードしたデータの処理中に CLE2 は、ジオメトリを内部固定グリッドで分割するルックアップインデックスを作成します。 ジオメトリが複数のグリッドタイルにまたがる場合、検索インデックスには、アップロードされたジオメトリのより小さなスライスが含まれている可能性があります。 この動作では、最初に送信されたジオメトリの関連する部分のみを返すことができるため、応答サイズと処理時間を削減できるため、検索パフォーマンスの向上と最適化された戻り値を実現できます。

検索を実行する前に、検索領域の周囲のタイル内にある形状の一部のみに関心があるか（つまり、タイル状の「ローカル」形状）、または元々アップロードされた完全な形状を受け取るかを指定できます。

図 1. ローカルおよびフルジオメトリ

次の 3 つのオプションを使用して、すべての結果を要求するか、ローカルの結果を要求するかを定義できます。 次のオプションは、すべての検索タイプで使用できます。

プロキシミティ検索要求の例

カスタムの場所検索を実行するには、CLE2ProximityRequest(String layerId, GeoCoordinate center, int radius)またはCLE2ProximityRequest(List<String> layerIds, GeoCoordinate center, int radius)コンストラクタのメソッドを使用してCLE2ProximityRequestを作成する必要があります。

近接検索では GeoCoordinate 、特定の場所の指定した半径内にあるカスタムの場所のリストが返されます。 たとえば、次のコードは、フランクフルト中央駅から半径 8 km 以内に存在する、前述の Stores レイヤー内のすべての場所を検索する方法を示しています。

String layerId = "HERE_SITES";
int radius = 8000; // 8 km
GeoCoordinate location = new GeoCoordinate(49.196261, -123.004773);
CLE2ProximityRequest req = new CLE2ProximityRequest(layerId, location, radius);
req.execute(new CLE2Request.CLE2ResultListener() {
  @Override
  public void onCompleted(CLE2Result result, String error)
  {
    // if CLE2Error.NONE.equals(error) is true, the request was successful
    if (error.equals(CLE2Error.NONE)) {
      List<CLE2Geometry> gemetry = result.getGeometries();
      for (CLE2Geometry geo : gemetry) {
        java.util.Map<String, String> attributeMap = geo.getAttributes();
        String name = attributeMap.get("NAME1");
        double distance = geo.getDistance();
      }
    }
  }
});

layerId このパラメータは、カスタムの場所のセットを表します。 たとえば、layerID="HERE_SITES" ドイツの HERE の場所を含むサンプルレイヤーを表します。 また、異なるレイヤーで近接検索を同時に実行することもできます。

List<String> layerIds = new ArrayList<String>();
layerIds.add("LAYER_1");
layerIds.add("LAYER_2");
int radius = 500; // 500 meters
GeoCoordinate location = new GeoCoordinate(50.113905,8.677608);
CLE2ProximityRequest req = new CLE2ProximityRequest(layerIds, location, radius);
req.execute(new CLE2Request.CLE2ResultListener() {
  @Override
  public void onCompleted(CLE2Result result, String error)
  {
    // if CLE2Error.NONE.equals(error) is true, the request was successful
    if (error.equals(CLE2Error.NONE)) {
      List<CLE2Geometry> gemetry = result.getGeometries();
      for (CLE2Geometry geo : gemetry) {
        java.util.Map<String, String> attributeMap = geo.getAttributes();
        String name = attributeMap.get("NAME1");
        double distance = geo.getDistance();
      }
    }
  }
});

リクエストオブジェクトを作成した後 execute(ResultListener) 、メソッドを呼び出して検索リクエストを起動し、検索結果をリッスンできます。

リクエストにフィルタを追加することもできます。 フィルターは、位置一致の検索クエリごとに評価される、 JavaScript に似た式です。 指定する true と、式が評価される場所のみが返されます。 たとえば、カスタムの location パラメータが rating greater than 3 および name である場所の結果をフィルタリングする場合 "MyPlace23"は、次の手順を実行します。

String layerId = "HERE_SITES";
int radius = 8000; // 8 km
GeoCoordinate location = new GeoCoordinate(49.196261, -123.004773);
CLE2ProximityRequest req = new CLE2ProximityRequest(layerId, location, radius);
String filter = "CITY == 'Burnaby' && NAME1 != 'MyPlace'";
req.setQuery(filter);
req.execute(new CLE2Request.CLE2ResultListener() {
  @Override
  public void onCompleted(CLE2Result result, String error)
  {
    // if CLE2Error.NONE.equals(error) is true, the request was successful
    if (error.equals(CLE2Error.NONE)) {
      List<CLE2Geometry> gemetry = result.getGeometries();
      for (CLE2Geometry geo : gemetry) {
        java.util.Map<String, String> attributeMap = geo.getAttributes();
        String name = attributeMap.get("NAME1");
        double distance = geo.getDistance();
      }
    }
  }
});

結果を反復処理しています

CLE2Result オブジェクトには、検索結果のジオメトリのリストが含ま getGeometries() れ、メソッドで使用できるようになります。 さまざまな種類のジオメトリを返すことができるため、使用する前にタイプをテストすることをお勧めします。 たとえば CLE2ResultListener 、次の例のような方法でを使用できます。

CLE2ResultListener resultListener = new CLE2Request.CLE2ResultListener() {
  @Override
  public void onCompleted(CLE2Result result, String error) {
    if (!error.equals(CLE2Request.CLE2Error.NONE)) {
      // process search results
      for (CLE2Geometry geometry : result.getGeometries()) {
        if (geometry instanceof CLE2PointGeometry) {
          CLE2PointGeometry point = (CLE2PointGeometry) geometry;
          // work with point geometry data
        }
      }
    } else {
      // handle error
    }
  }
};