イベント

本SDKは、以下のイベントをハンドリングすることができます。

マップイベント

マップイベントは、地図に関するイベントです。
マップイベントには以下があります。

地図利用可能イベント

地図が利用可能になったときに発生するイベントです。
本SDKでの地図の操作は、このイベントでマップオブジェクト[ZDCMap]を受け取ることで可能になります。
OnMapReadyCallbackインターフェースを実装したクラスオブジェクトを、下記メソッドに登録することでイベントを受け取ることができます。

  • MapFragment.getMapAsync(OnMapReadyCallback)
  • MapView.getMapAsync(OnMapReadyCallback)

カメラ位置変更イベント

カメラ位置が変更されたときに発生するイベントです。
変更されたカメラ情報(緯度経度、ズームレベル、回転、チルト)を通知します。
OnCameraChangeListenerインターフェースを実装したクラスオブジェクトを、下記メソッドに登録することでイベントを受け取ることができます。

  • ZDCMap.setOnCameraChangeListener(OnCameraChangeListener)

マップクリックイベント

マップがクリックされたときに発生するイベントです。
クリックされた位置情報(緯度経度)を通知します。
OnMapClickListenerインターフェースを実装したクラスオブジェクトを、下記メソッドに登録することでイベントを受け取ることができます。

  • ZDCMap.setOnMapClickListener(OnMapClickListener)

マップロングクリックイベント

マップが長押しされたときに発生するイベントです。
クリックされた位置情報(緯度経度)を通知します。
OnMapLongClickListenerインターフェースを実装したクラスオブジェクトを、下記メソッドに登録することでイベントを受け取ることができます。

  • ZDCMap.setOnMapLongClickListener(OnMapLongClickListener)

マップ読み込み完了イベント

マップが読み込み完了したときに発生するイベントです。
OnMapLongClickListenerインターフェースを実装したクラスオブジェクトを、下記メソッドに登録することでイベントを受け取ることができます。

  • ZDCMap.setOnMapLongClickListener(OnMapLongClickListener)

表示範囲の全タイルの読み込みが完了したときに一度だけ呼ばれます。
タイルの一部が読み込めていなかったり、マップの操作中の時には発生しません。
再度本イベントを受け取りたい場合は、クラスオブジェクトの登録をやり直してください。

現在位置ボタンクリックイベント

現在位置ボタンがクリックされたときに発生するイベントです。
OnMyLocationButtonClickListenerインターフェースを実装したクラスオブジェクトを、下記メソッドに登録することでイベントを受け取ることができます。

  • ZDCMap.setOnMyLocationButtonClickListener(OnMyLocationButtonClickListener)

イベントの戻り値として、trueを返すとデフォルトの操作が動きます。
falseを返すとデフォルトの操作は動きません。
(デフォルトの操作はカメラ位置を現在位置に移動させます)

現在位置変更イベント

現在位置が変更したときに発生するイベントです。
変更後の現在位置(緯度経度)を通知します。
OnMyLocationChangeListenerインターフェースを実装したクラスオブジェクトを、下記メソッドに登録することでイベントを受け取ることができます。

  • ZDCMap.setOnMyLocationChangeListener(OnMyLocationChangeListener)

範囲外通知イベント

カメラ位置が移動範囲外に到達したときに発生するイベントです。
現在のカメラ情報を通知します。
OnOutOfAreaListenerインターフェースを実装したクラスオブジェクトを、下記メソッドに登録することでイベントを受け取ることができます。

  • ZDCMap.setOnOutOfAreaListener(OnOutOfAreaListener)

移動範囲はZDCMap.setMovableArea(LatLngBounds)メソッドで設定します。

エラー通知イベント

本SDKでエラーが起こったときに発生するイベントです。
エラーコードを通知します。
OnOutOfAreaListenerインターフェースを実装したクラスオブジェクトを、マップ初期化時に登録することでイベントを受け取ることができます。

  • MapInitializer.initialize(String, String, OnErrorOccurredCallback)
図形イベント

図形イベントは、ユーザーがマップに追加した各図形に関するイベントです。
図形イベントには以下があります。

サークルクリックイベント

サークルがクリックされたときに発生するイベントです。
クリックされたサークルオブジェクトを通知します。
OnCircleClickListenerインターフェースを実装したクラスオブジェクトを、下記メソッドに登録することでイベントを受け取ることができます。

  • ZDCMap.setOnCircleClickListener(OnCircleClickListener)

プロパティのclickableがtrueのものがクリック判定の対象となります。
非表示(visible=false)の場合でもクリックされた場合は通知されます。

グラウンドオーバーレイクリックイベント

グラウンドオーバーレイがクリックされたときに発生するイベントです。
クリックされたグラウンドオーバーレイオブジェクトを通知します。
OnGroundOverlayClickListenerインターフェースを実装したクラスオブジェクトを、下記メソッドに登録することでイベントを受け取ることができます。

  • ZDCMap.setOnGroundOverlayClickListener(OnGroundOverlayClickListener)

プロパティのclickableがtrueのものがクリック判定の対象となります。
非表示(visible=false)の場合でもクリックされた場合は通知されます。

ラベルクリックイベント

ラベルがクリックされたときに発生するイベントです。
クリックされたラベルオブジェクトを通知します。
OnLabelClickListenerインターフェースを実装したクラスオブジェクトを、下記メソッドに登録することでイベントを受け取ることができます。

  • ZDCMap.setOnLabelClickListener(OnLabelClickListener)

プロパティのclickableがtrueのものがクリック判定の対象となります。
非表示(visible=false)の場合でもクリックされた場合は通知されます。

ポリゴンクリックイベント

ポリゴンがクリックされたときに発生するイベントです。
クリックされたポリゴンオブジェクトを通知します。
OnPolygonClickListenerインターフェースを実装したクラスオブジェクトを、下記メソッドに登録することでイベントを受け取ることができます。

  • ZDCMap.setOnPolygonClickListener(OnPolygonClickListener)

プロパティのclickableがtrueのものがクリック判定の対象となります。
非表示(visible=false)の場合でもクリックされた場合は通知されます。

ポリラインクリックイベント

ポリラインがクリックされたときに発生するイベントです。
クリックされたポリラインンオブジェクトを通知します。
OnPolylineClickListenerインターフェースを実装したクラスオブジェクトを、下記メソッドに登録することでイベントを受け取ることができます。

  • ZDCMap.setOnOnPolylineClickListener(OnPolylineClickListener)

プロパティのclickableがtrueのものがクリック判定の対象となります。
非表示(visible=false)の場合でもクリックされた場合は通知されます。