Google.Maps.Event.MapEvents

地図の取得と読み込みに関連する一連のイベントをカプセル化します。

概要

公開属性
LoadError = new MapLoadErrorEvent()
地図の一部を読み込めなかったときに呼び出されます。
Loaded = new MapLoadedEvent()
MapsService.LoadMap への呼び出しからすべての Feature.MapFeature が読み込まれたときに呼び出されます。
Progress = new MapLoadProgressEvent()
地図の一部の読み込みが完了すると呼び出されます。

公開属性

LoadError

MapLoadErrorEvent LoadError = new MapLoadErrorEvent()

地図の一部を読み込めなかったときに呼び出されます。

このイベントの引数を変更することで、再試行動作を細かく制御できます。詳しくは、MapLoadErrorArgs をご覧ください。

Loaded

MapLoadedEvent Loaded = new MapLoadedEvent()

MapsService.LoadMap への呼び出しからすべての Feature.MapFeature が読み込まれたときに呼び出されます。

すでに読み込まれているエリアで LoadMap を呼び出すと、すぐにイベントがトリガーされます。

以前の呼び出しによる読み込みが完了する前（たとえば地図の周りをすばやくパンしている最中）に LoadMap を複数回呼び出すと、すべてが読み込まれた後にイベントが 1 回だけトリガーされます。

読み込み中にエラーが発生した場合は、MapLoadedArgs.Errors がゼロ以外になり、一部の MapFeature の準備ができていない可能性があります。LoadMap をもう一度呼び出して再試行します。

このコールバック内で地図リージョンを読み込みまたはアンロードするときは、無限コールバック ループが発生する可能性があるので注意してください。安全のために、Loaded イベントが完了するまで追加の読み込みを延期することをおすすめします。

Progress

MapLoadProgressEvent Progress = new MapLoadProgressEvent()

地図の一部の読み込みが完了すると呼び出されます。

このイベントを使用すると、地図の読み込みの進行状況を追跡できます。たとえばこのイベントを使って、進行状況バーを作動させることができます。