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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

次 setGeometryType: の方法を使用して、形状タイプを設定できます。

NMACLE2ProximityRequest *proximityRequest =
  [[NMACLE2ProximityRequest alloc] initWithLayer:searchLayer center:coordinates radius:radius];
[proximityRequest setGeometryType:NMACLE2GeometryFull];
      

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

カスタムの位置情報検索を実行するに NMACLE2ProximityRequestinitWithLayer:center:radiusinitWithLayers:center:radius は、またはのメソッドを使用してを作成する必要があります。

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

NMACLE2ProximityRequest * proximityRequest;
proximityRequest= [[NMACLE2ProximityRequest alloc] initWithLayer:@"HERE_SITES"
       center:[NMAGeoCoordinates geoCoordinatesWithLatitude:49.196261
          longitude:-123.004773]
       radius:8000]; // 8km

// Perform the request
[proximityRequest startWithBlock:^(NMACLE2Request *request, NMACLE2Result * result, NSError *error) {
    if(!error) {
      // use result.geometriesArray to retrieve list of found NMACLE2Geometry results
    }
  }];

Layer ID パラメータは、カスタムアップロードされたジオメトリのセットを表します。 たとえば 、"HERE_SITES"レイヤー ID は 、ドイツの HERE オフィスの場所を含むサンプルレイヤーを表します。 オフィスは単純な点で表されるため、返される形状のタイプはです NMACLE2GeometryPoint。

また、異なるレイヤーで近接検索を同時に実行することもできます。

NSArray *layers = @[@"LAYER_1", @"LAYER_2"];
NMACLE2ProximityRequest * proximityRequest;
proximityRequest= [[NMACLE2ProximityRequest alloc] initWithLayers:layers
       center:[NMAGeoCoordinates geoCoordinatesWithLatitude:50.113905
              longitude:8.677608]
       radius:500]; // 500 meters

// Perform the request
[proximityRequest startWithBlock:^(NMACLE2Request *request, NMACLE2Result * result, NSError *error) {
    if(!error) {
      // use result.geometriesArray to retrieve list of found NMACLE2Geometry results
    }
  }];

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

リクエストにフィルタを追加することもできます。 フィルターは、位置一致の検索クエリごとに評価される、 JavaScript に似た式です。 指定すると、属性が一致する場合など、式が true と評価されるジオメトリのみが返されます。 たとえば、のカスタム位置パラメーターが rating より大きい 3 で、属性が「NAME」 AS のジオメトリを検索する場合 "MyPlace23"は、次の手順を実行します。

NMACLE2ProximityRequest * proximityRequest;
proximityRequest= [[NMACLE2ProximityRequest alloc] initWithLayer:@"HERE_SITES"
       center:[NMAGeoCoordinates geoCoordinatesWithLatitude:49.196261
              longitude:-123.004773]
       radius:8000]; // 8 km

[proximityRequest setQuery:@"CITY == 'Burnaby' && NAME1 != 'MyPlace'"];

// Perform the request
[proximityRequest startWithBlock:^(NMACLE2Request *request, NMACLE2Result * result, NSError *error) {
    if(!error) {
      // use result.geometriesArray to retrieve list of found NMACLE2Geometry results
    }
  }];

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

NMACLE2Result オブジェクトには NSArrayNMACLE2Geometry 、検出されたすべてのオブジェクトを含むが含まれています。 異なるオブジェクトを返すことができるため、返されたジオメトリを使用する前に、型をテストすることをお勧めします。 たとえば、リクエスト完了ブロック内で次の操作を実行できます。

for (NMACLE2Geometry *currentLocation in result.geometries) {
  if([currentLocation isKindOfClass:[NMACLE2GeometryMultiPoint class])
  {
    NMACLE2GeometryMultiPoint *multiPoint = (NMACLE2GeometryMultiPoint *)currentLocation;
    // multiPoint.coordinatesArray is an NSArray containing the found NMAGeoCoordinates
    NSLog(@"Found %lu coordinates", (unsigned long)[multiPoint.coordinatesArray count]);
    NSLog(@"Geometry attributes: %@", multiPoint.attributes);
  }
}

検索さ NMACLE2GeometryMultiPointNSArrayNSDictionary れた各プロパティには、座標と柔軟なユーザー定義フィールドを持つ属性の 2 つの重要なプロパティが含まれています。