地図

GitHub でのマップレンダリングの例

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

NMAMapView の操作

NMAMapView が初期化されると、さまざまな方法で操作および操作できます。 の主な属性に NMAMapView は、その向き、傾き、地理的中心 ()geoCenter、およびズーム レベル () がありzoomLevelます。 これらのプロパティを使用 NMAMapView して、表示をカスタマイズできます。 たとえば、カナダのバンクーバーのビューを表示する方法を次のコードで示します。

NMAGeoCoordinates *geoCoordCenter = [[NMAGeoCoordinates alloc]
  initWithLatitude:49.260327 longitude:-123.115025];
[self.mapView setGeoCenter:geoCoordCenter withAnimation:NMAMapAnimationNone];

これらのイベントの開始および終了は、 NMAMapView デリゲートプロパティにオブジェクトを割り当てることによって監視できます。 オブジェクトは NMAMapViewDelegate 、受け取るイベントに対応するプロトコルのメソッドを実装する必要があります。 このデリゲートを使用 して、マップ オブジェクトの選択を検出することもできます。

地図投影モード

mapView.projectionType = NMAProjectionTypeMercator;

図 1. 地球儀投影

図 2. メルカトル図法

スナップショットをマップします

NMAMapView のプロパティ

次の例は、の一部のプロパティの操作方法を示し NMAMapViewています。

地図の中央

地図の中央によって、表示する地理的領域が決まります。 NMAMapView geoCenter プロパティを使用して読み取り、いずれかの setGeoCenter: メソッドを使用して設定できます。 タイプはです NMAGeoCoordinates。

// Move the map to London
NMAGeoCoordinates *geoCoordCenter = [[NMAGeoCoordinates alloc]
initWithLatitude:51.51 longitude:-0.11];
[self.mapView setGeoCenter:geoCoordCenter withAnimation:NMAMapAnimationNone];

ズーム レベル

地図に表示される地理的領域のサイズは、ズーム レベルを変更して制御できます。 ズーム レベルの範囲は NMAMapView::minimumZoomLevel ～ NMAMapViewMaximumZoomLevelで、ズーム値が高いほど地面に近づきます。 次のコードでは、ズーム レベルを Median ズーム レベルに設定します。

// Set the zoom level to the median
mapView.zoomLevel =
(mapView.minimumZoomLevel + NMAMapViewMaximumZoomLevel)/2.0f;

// Rotate by 180 degrees
mapView.orientation = 180;

// Set the tilt to 45 degrees
mapView.tilt = 45;

アニメーション

で NMAMapView は NMAMapAnimation 、 列挙型 (enum) によって定義されたプロパティの変更時に使用される次のアニメーション設定がサポートされています。

// Rotate by 90 degrees using a linear animation
[mapView setOrientation:90 withAnimation:NMAMapAnimationLinear];

// Move to London using bow animation
NMAGeoCoordinates *geoCoordCenter = [[NMAGeoCoordinates alloc]
    initWithLatitude:51.51 longitude:-0.11];
[mapView setGeoCenter:geoCoordCenter withAnimation:NMAMapAnimationLinear];

-(void) setGeoCenter:(NMAGeoCoordinates*) coordinates
           zoomLevel:(float) level
           orientation:(float) orientation
              tilt:(float) tilt
         withAnimation:(NMAMapAnimation) animation

// Move to Vancouver using bow animation, zoom level 17, 180
// degree orientation and preserve tilt
NMAGeoCoordinates* coord = [[NMAGeoCoordinates alloc]
  initWithLatitude:49.1
  longitude:123.0];
[mapView setGeoCenter:coord
  zoomLevel:17.0f
  orientation:180
  tilt:NMAMapViewPreserveValue
  withAnimation:NMAMapAnimationBow];

イベントブロックをマップします

マップイベントブロックを使用すると、マップイベントのカスタム処理を簡単かつ多用途に追加できます。 このメカニズムを使用すると、特定のマップイベントが発生したときにアプリケーションで任意のコードを実行できます。 アプリケーションでは、を使用してこのコードを定義でき NMAMapEventBlockます。 各ブロックは、 1 つ以上のイベントに応答するように登録できます。また、特定のイベントタイプへの応答を継続するかどうかを動的に制御できます。

変換とは、ユーザーまたはアプリケーションが変更を行ったかどうかにかかわらず、地図のジオエンター、ズーム レベル、方向、およびチルトの値に対する変更を指します。 1 つの変換開始イベントと変換終了イベントのセットの間に、アニメーション、ジェスチャなど、さまざまなソースからの複数の変換が存在する場合があります。 たとえば、アプリケーションがマップのアニメーションをトリガーし、マップが静止状態の場合、 NMAMapEventTransformationBegan NMAMapEventAnimationBegan イベントが発生します。 ユーザーがアニメーションが完了する前にジェスチャを実行すると、 NMAMapEventAnimationEnded NMAMapEventGestureBegan イベントが発生します。 最後に、ユーザーがジェスチャを終了すると、 NMAMapEventGestureEnded NMAMapEventTransformationEnded イベントが発生します。

マップイベントブロックを登録するに respondToEvents:withBlock: は、メソッドを使用して、ブロックが応答するイベントを設定します。 たとえば、地図のジェスチャまたはアニメーションがあるときにオーバーレイを非表示にするには、次のようにします。

[_mapView respondToEvents:(NMAMapEventGestureBegan | NMAMapEventAnimationBegan) withBlock:^(NMAMapEvent event, NMAMapView *mapView, id eventData) {
  // _myOverlay is an informative overlay on the map
  _myOverlay.hidden = YES;
  return YES;
}];

[_mapView respondToEvents:(NMAMapEventGestureEnded | NMAMapEventAnimationEnded) withBlock:^(NMAMapEvent event, NMAMapView *mapView, id eventData) {
  // _myOverlay is an informative overlay on the map
  _myOverlay.hidden = NO;
  return YES;
}];

イベントブロックが戻ると YES、関連するイベントがトリガーされたときにイベントブロックが引き続き実行されます。 イベントブロックが戻ると NO、その特定のトリガーイベントのイベントブロックが削除されます。 ( 同じブロックが他のイベントタイプにも登録されている場合は、それらのイベントに応答します ) 。 たとえば、次のコードでは、現在のアニメーションが終了したときに 1 回限りのアクションを実行します。

[_mapView respondToEvents:NMAMapEventAnimationEnded withBlock:^(NMAMapEvent event, NMAMapView *mapView, id eventData) {
  // Do something...
  return NO;  // This block will be removed after being called once
}];

respondToEvents:withBlock: メソッドは、登録されているブロックを識別する一意の整数値を返します。 ブロックの登録を解除するに removeEventBlockWithIdentifier: は、この整数値でを呼び出します。

地図表示レイヤー

道路ラベルや公園名などの地図情報は、表示レイヤーにグループ化されます。 これらのレイヤーはカテゴリとしてグループ化 NMAMapLayerCategory され、列挙体で表されます。 デフォルト NMAMapView では、すべてのレイヤーがマップ ビューに表示されるように設定されています。また、次の方法を使用して、非表示にするかどうかを制御できます。

• isMapLayerCategoryVisible: - マップレイヤーのカテゴリが表示されているかどうかを確認します
• setVisibility:forMapLayerCategories: - マップレイヤーの指定したカテゴリを表示するかどうかを設定します
• visibleMapLayerCategories - NSArray マップレイヤーの現在表示されているカテゴリを表すを取得します

地図表示レイヤーカテゴリの全リストについて NMAMapLayerCategoryは、 API リファレンス for を参照してください。

場所のカテゴリ

[mapview setVisibility:NO forPoiCategory:NMAMapPoiCategoryPetrolStation];

歩行者機能

デフォルト NMAMapViewでは、歩行者アクセス機能（階段やエスカレーターなど）を示すアイコンはに表示されません。 マップ ビューに歩行者機能を表示するには、 NMAMapPedestrianFeatureType 必要に応じて showPedestrianFeature:pedestrianFeature メソッドを呼び出します。 同様 hidePedestrianFeature:pedestrianFeature に、メソッドを呼び出して徒歩機能を非表示にできます。 機能タイプが有効になっているかどうかを確認するに isPedestrianFeatureShown:pedestrianFeature は、メソッドを呼び出します。

図 3. 歩行者機能アイコン

割り込み処理

デフォルト NMAMapView では、 Control Center メニューの表示中やシステム通知の受信中など、アプリケーションがアクティブ状態でなくなったときにマップのレンダリングを一時停止します。 pauseOnWillResignActive この動作を無効にするには、プロパティをに設定し NOます。 自動一時停止が無効になっている場合、アプリケーションは、 renderAllowed プロパティを NO に設定して、バックグラウンドに移動したときにマップ ビューレンダリングを手動で一時停止する必要があります。