検索と発見

検索を実行する手順

1. NMAResultListener 検索の完了を処理するプロトコルを実装します。
2. NMAPlaces ファクトリを使用してリクエストを作成します。
3. を呼び出して、リクエストを呼び出し NMARequest startWithListener:ます。
4. NMAResultListener request:didCompleteWithData:error: コールバックは、リクエストが終了するとトリガーされます。

検出リクエスト

HERE Places API では、次のディスカバリ要求がサポートされています リクエストは、のファクトリメソッドを使用して作成 NMAPlacesされます。

// Sample Search request listener
@interface NMASearchTest : NSObject<NMAResultListener> {
  NMADiscoveryPage* _result;
}
@end
@implementation NMASearchTest

// NMAResultListener protocol callback implementation
- (void)request:(NMARequest*)request
    didCompleteWithData:(id)data
    error:(NSError*)error
{
  if ( ( [request isKindOfClass:[NMADiscoveryRequest class]]) &&
    ( error.code == NMARequestErrorNone ) )
  {
    // Process result NMADiscoveryPage objects
    _result = (NMADiscoveryPage*) data;
  }
  else
  {
    // Handle error
    ...
  }
}
- (void) startSearch
{
  // Create a request to search for restaurants in Vancouver
  NMAGeoCoordinates* vancouver =
  [[NMAGeoCoordinates alloc] initWithLatitude:49.2849
          longitude:-123.1252];

  NMADiscoveryRequest* request =
  [[NMAPlaces sharedPlaces] createSearchRequestWithLocation:vancouver
          query:@"restaurant"];

  // optionally, you can set a bounding box to limit the results within it.
  NMAGeoCoordinates *boundingTopLeftCoords = [[NMAGeoCoordinates alloc] initWithLatitude:49.277484 longitude:-123.133693];
  NMAGeoCoordinates *boundingBottomRightCoords = [[NMAGeoCoordinates alloc] initWithLatitude:49.257209 longitude:-123.11275];
  NMAGeoBoundingBox *bounding = [[NMAGeoBoundingBox alloc] initWithTopLeft:boundingTopLeftCoords bottomRight:boundingBottomRightCoords];

  request.viewport = bounding;

  // limit number of items in each result page to 10
  request.collectionSize = 10;

  NSError* error = [request startWithListener:self];
  if (error.code != NMARequestErrorNone)
  {
    // Handle request error
    ...
  }
}
@end

アプリケーションが最適な検索結果を取得できるようにする viewport には、バウンディング ボックスをプロパティに設定して、検索リクエストに位置情報コンテキストを設定します。 前の例では、を NMAGeoBoundingBox からのビューポイントで置き換えることもでき NMAMapViewます。

NMADiscoveryPage.nextPageRequest が nil の場合、追加の結果はありません。

次に例を示します。

...
@interface NMANextPageTest : NSObject<NMAResultListener> {
  NMADiscoveryPage* _page;  // valid NMADiscoveryPage instance
}
@end
@implementation NMANextPageTest
- (void)onNextPageAction
{
  NSError* error = [_page.nextPageRequest startWithListener:self];
  if ( error.code == NMARequestErrorNone )
  {
    // More data is available
  }
}

// NMAResultListener protocol callback implementation
- (void)request:(NMARequest*)request
    didCompleteWithData:(id)data
    error:(NSError*)error
{
  if ( ( [request isKindOfClass:[NMADiscoveryRequest class]] ) &&
    ( error.code == NMARequestErrorNone ) )
  {
    // Process NMADiscoveryPage objects
  }
  else
  {
    // Handle error
    ...
  }
}
...
@end

@interface NMASearchTest : NSObject<NMAResultListener> {
  NMADiscoveryPage* _result;
}
@end
@implementation NMASearchTest
// Retrieve the place details when the user selects a displayed PlaceLink.
- (void)onPlaceLinkSelected:(NMAPlaceLink*)placeLink
{
  NSError* error = [[placeLink detailsRequest] startWithListener:self];
  if ( error.code == NMARequestErrorNone )
  {
    // More data will available.
    ...
  }
}

// NMAResultListener protocol callback implementation
- (void)request:(NMARequest*)request
    didCompleteWithData:(id)data
    error:(NSError*)error
{
  if ( ( [request isKindOfClass:[NMADiscoveryRequest class]]) &&
     ( error.code == NMARequestErrorNone ) )
  {
    _result = (NMADiscoveryPage*) data;
    NSArray* discoveryResult = _result.discoveryResults;

    for ( NMALink* link in discoveryResult )
    {
      if ( link isKindOfClass:[NMADiscoveryLink class] )
      {
        NMADiscoveryLink* discoveryLink = (NMADiscoveryLink*) link;

        // NMADiscoveryLink can also be presented to the user.
        // When a NMADiscoveryLink is selected, another search request should be
        // performed to retrieve results for a specific category.
        ...
      }
      else if ( link isKindOfClass:[NMAPlaceLink class] )
      {
        NMAPlaceLink* placeLink = (NMAPlaceLink*) link;

        // NMAPlaceLink should be presented to the user, so the link can be
        // selected in order to retrieve additional details about a place
        // of interest.
        ...
      }
    }
  }
  else  if ( ( [request isKindOfClass:[NMAPlaceRequest class]]) &&
         ( error.code == NMARequestErrorNone ) )
  {
    NMAPlace* place = (NMAPlace*)data;
    // Access to additional details about a place of interest.
  }
  else
  {
    // Handle error
    ...
  }
}
@end

GitHub でサンプルを検索します

この機能を示す例について は、 https://github.com/heremaps/ (Obj-C) および https://github.com/heremaps/ (Swift) を参照してください。

NMAPlace クラス

カテゴリフィルタ

美術館、レストラン、コーヒーショップなどのカテゴリに関心のある場所を関連付けることができます。 エクスプローラまたは HERE の検出リクエストを作成するときに、より具体的な結果セットを取得するためのカテゴリフィルタを提供することを選択できます。 たとえば、バンクーバー市庁舎の近くにある寿司屋を検索できます。

カテゴリのリストを取得するには、 NMAPlaces で topLevelCategories メソッドを呼び出します。 このカテゴリのリストから、 1 つ以上のレベルのサブカテゴリを取得できます。 たとえば、「レストラン」カテゴリの「バー / パブ」などです。 カテゴリを作成したら NMACategoryFilter 、オブジェクトを作成し addCategoryFilterFromUniqueId てメソッドを呼び出します。 各 NMACategoryFilter オブジェクトは複数のカテゴリを表すことができます。

NSArray* categories = [[NMAPlaces sharedPlaces] topLevelCategories];

for (id category in categories)
{
  if (category.uniqueId == "restaurant" )
  {
    NMACategory* restCategory = category;
    NMAGeoCoordinates* vancouver = [[NMAGeoCoordinates alloc]
                    initWithLatitude:49.2849
                    longitude:-123.1252];

    NMACategoryFilter *categoryFilter = [NMACategoryFilter new];
    [categoryFilter addCategoryFilterFromUniqueId:restCategory.uniqueId];

    NMADiscoveryRequest* request = [ [NMAPlaces sharedPlaces]
                createHereRequestWithLocation:vancouver
                filters:categoryFilter];
    //...
  }
}

AutoSuggest のリクエストを入力してください

HERE Places 検索 API では、テキスト自動結合リクエストもサポートされています。 このタイプのリクエストは、指定した場所のコンテキストおよび部分的な検索条件に関連付けられている、 インスタント結果 (NMAAutoSuggestTypePlace) および詳細な検索リンク (NMAAutoSuggestTypeSearch) のリストを取得するために使用されます。 たとえば、ベルリンで文字列「 REST 」を使用してリクエストを作成すると、結果には「レストラン」、「 REST area 」、「 Restorf 、 H ö hbeck 、 Germany 」などの検索語が含まれます。

テキストの自動集計を使用するには、次のようにリスナーを実装して NMAAutoSuggest のリストを処理し、 createAutoSuggestionRequestWithLocation:partialTerm: 呼び出します。

// Sample Search request listener
@interface NMATextAutoSuggestionSearchTest : NSObject<NMAResultListener> {

}
@end
@implementation NMATextAutoSuggestionSearchTest

// NMAResultListener protocol callback implementation
- (void)request:(NMARequest*)request
  didCompleteWithData:(id)data
      error:(NSError*)error
{
  if (([request isKindOfClass:[NMAAutoSuggestionRequest class]]) &&
     (error.code == NMARequestErrorNone))
  {
    // Results are held in an array of NMAAutoSuggest objects
    // You can then check the subclass type using the NMAAutoSuggest.type property
    NSArray* textAutoSuggestionResult = (NSArray*) data;
  }
  else
  {
    // Handle error
    ...
  }
}
- (void)startSearch
{
  NMAGeoCoordinates *vancouver =
      [[NMAGeoCoordinates alloc] initWithLatitude:49.2849
            longitude:-123.1252];

  // Use following filter to show results only in the Canada
  NMAAddressFilter *filter = [[NMAAddressFilter alloc] init];
  filter.countryCode = @"CAN";
  NMAAutoSuggestionRequest *request =
    [[NMAPlaces sharedPlaces] createAutoSuggestionRequestWithLocation:vancouver
      partialTerm:@"rest" filter:filter];

  // limit number of items in each result page to 10
  request.collectionSize = 10;

  NSError *error = [request startWithListener:self];
  if (error.code != NMARequestErrorNone)
  {
    // Handle request error
    ...
  }
}
@end

NMAAutoSuggestionRequest 次 NMAAutoSuggest の例に示すように、まずオブジェクトタイプを確認することで、の結果を取得できます。 オブジェクトが NMAAutoSuggestTypeSearch の場合は、その NMADiscoveryRequest オブジェクトを通して追加のページ設定された結果が含まれます。 オブジェクトが NMAAutoSuggestTypePlace の場合は、その NMAPlaceRequest オブジェクトを使用して詳細情報を要求できます。

+(BOOL)checkAutoSuggestResults:(NSArray*)array
{
  for (id item in array) {
    NMAAutoSuggestType type = ((NMAAutoSuggest*)item).type;
    NSString *typeString;
    switch (type){
      caseNMAAutoSuggestTypePlace:
      {
        typeString = @"Place";
      }
        break;
      caseNMAAutoSuggestTypeSearch:
      {
        typeString = @"Search";
      }
        break;
    }

    NSLog(@"Type = %@", typeString);

    NMAAutoSuggest* suggestItem = (NMAAutoSuggest*)item;

    //Retrieve information such as suggestItem.title

    if (type == NMAAutoSuggestTypePlace) {

      NMAAutoSuggestPlace* suggestPlace = (NMAAutoSuggestPlace*)item;

      //Retrieve information such as suggestPlace.vicinityDescription

      NMAPlaceRequest* detailsRequest = suggestPlace.placeDetailsRequest;

      // Get NMAPlaceResult by calling detailsRequest startWithListener:
      // ...

    } else if (type == NMAAutoSuggestTypeSearch) {

      NMAAutoSuggestSearch* suggestSearch = (NMAAutoSuggestPlace*)item;

      //Retrieve information such as suggestSearch.position

      NMADiscoveryPage* discoveryPage;
      NMADiscoveryRequest* discoveryRequest = suggestSearch.suggestedSearchRequest;

      // Get discoveryPage by calling [discoveryRequest startWithListener:]
      // ...
    }
  }
  return YES;
}
      

外部参照

関心のある場所に は、 HERE SDK 外部の外部システムへの参照を含めることができます。 たとえば NMAPlace 、レストランを表すには、レストランレビューサービスのエントリへの外部参照を含めることもできます。 の各外部参照 NMAPlace は参照ソースに関連付けられており、各参照には 1 つ以上の識別子を含めることができます。

外部参照は、 NMAPlaceLink、 NMAPlaceLocation 、または NMAPlace の 1 つ以上の識別子の形式 NSString で返されます。 参照を要求するに NMARequest は、にソース（ディスカバリ要求など）を追加し、同じソース名を使用して結果から参照を取得する必要があります。 たとえば、

// Create a request to search for restaurants in Vancouver
NMAGeoCoordinates* vancouver =
[[NMAGeoCoordinates alloc] initWithLatitude:49.2849
        longitude:-123.1252];
NMADiscoveryRequest* request =
[[NMAPlaces sharedPlaces] createSearchRequestWithLocation:vancouver
        query:@"restaurant"];

// We also want to retrieve the Yelp ID external reference
[request addSource:@"yelp"];

request.collectionSize = 10;
NSError* error = [request startWithListener:self];

リクエストの実行が完了したら referenceIdentifiersForSource: 、次のようにメソッドを使用して結果を取得できます。

...
if ( resultLink isKindOfClass:[NMAPlaceLink class] )
{
  NMAPlaceLink* placeLink = (NMAPlaceLink*) resultLink;

  NSArray* yelpIds =
    [placeLink referenceIdentifiersForSource:@"yelp"];

  for(NSString* id in yelpIds) {
    NSLog(id); // retrieved Yelp ID
  }
}
...

追加の外部参照ソースは、次の例に示すように、詳細リクエストによってサポートされます。 たとえば detailsRequest 、のプロパティを使用し NMAPlaceLink て、詳細リクエストを実行して参照 ID を取得できます。

NMAPlaceRequest* placeDetailsRequest = receivedPlaceLink.detailsRequest;
[placeDetailsRequest addSource:NMAPlacesSourcePVID];
[placeDetailsRequest addSource:@"yelp"];
[placeDetailsRequest addSource:@"tripadvisor"];

[placeDetailsRequest startWithBlock:^(NMARequest *request, id data, NSError *error) {
  if (!error && data) {
    NMAPlace *place = (NMAPlace*)data;

    NSArray *pvids = [place referenceIdentifiersForSource:NMAPlacesSourcePVID];
    NSArray *yelpIds = [place referenceIdentifiersForSource:@"yelp”];
    NSArray *tripadvisorIds = [place referenceIdentifiersForSource:@"tripadvisor”];
  }
}];

逆のシナリオで外部 PVID 参照を使用して、createLookupRequestWithReferenceIdentifier:inSource: メソッドを使用して特定の NMAPlace を取得することもできます。 例 :

NMAPlaceRequest* request = [ [NMAPlaces sharedPlaces]
  createLookupRequestWithReferenceIdentifier:@"1126226306"
  inSource:NMAPlacesSourcePVID ];

ハイブリッド車検索

オフライン検索をサポート するために、 HERE SDK には、オンライン検索と比較して場所のサブセットが含まれている場所のデータベースが事前に読み込まれています。 インターネット接続が利用できず、既定の接続モードでプレース検索が実行された場合、このデータベースのエントリの基本的なプレース情報のみが返されます ( 評価やレビューなどのリッチデータは含まれません ) 。 ただし、インターネット接続が再確立される と、 HERE SDK はオンラインの場所の結果を再度取得します。