基本的な使い方サービスを利用するプラグインを利用する注記クリックプラグイン(Y.MapAnnotationPlugin)経路探索プラグイン(Y.RouteSearchPlugin)GeoXml切り替えプラグイン(Y.GeoXmlPlugin)独自プラグインの作成サンプルコードレファレンス注記クリックプラグイン(Y.MapAnnotationPlugin)注記クリックプラグインは、地図上の交差点や店舗アイコンといった、注記情報を取得する機能を提供します。この機能は、注記クリックプラグイン(Y.MapAnnotationPlugin)をY.Mapオブジェクトに追加することで利用できます。地図上の注記がクリックされた際に、クリック対象となった注記情報を受け取ることが可能になります。//宣言済みのMapオブジェクト(変数名map)に注記クリックプラグインを設定するサンプルです。//注記をクリックした際に呼び出される関数を定義します。//注記の位置にマーカーを設定します。//注記の矩形を透過ポリゴンで描画します。map.addFeature(boundPolygon);};//地図の縮尺を変更した際に呼び出される関数を定義します。map.clearFeatures();};//注記クリックプラグインの設定を記述します。Y.MapAnnotationPlugin(configs);//プラグインをMapオブジェクトに追加します。map.addPlugin(annotationPlugin);//地図の縮尺が変更されたら、現在地図上に表示している注記情報を削除します。clearAnnotation);クリックされた位置に注記情報があったとき、annotationオブジェクトとして次のように構造化されたJSON形式で受け取ります。注記クリックプラグインを利用するサンプルページはこちらになります。経路探索プラグイン(Y.RouteSearchPlugin)経路探索プラグインは、指定した地点間の経路を探索して地図上に表示する経路探索レイヤーを、インタラクティブUIから操作できる機能を提供します。経路探索プラグイン(Y.RouteSearchPlugin)をY.Mapオブジェクトに追加することで利用できます。地図上で経路の操作を行う経路探索プラグインを使用することで、地図上で地点を指定して経路探索を行ったり、経路を編集したりできます。//宣言済みのMapオブジェクト(変数名map)に経路探索プラグインを設定するサンプルです。//プラグインをMapオブジェクトに追加します。経路探索プラグインを利用したサンプルページはこちらになります。経由地点に設定できます。これらの設定した地点にはマーカーが表示され、マーカーをマウスオーバーするとその地点の住所が表示されます。出発地点と到着地点の2点を設定すると自動的に経路探索を行います。経路はポリラインで地図上に描画されます。※地点間の総直線距離を1000km以下になるように設定してください。経路を編集するマーカーをドラッグ&ドロップすることで位置を修正できます。ポリラインをマウスオーバーすると、ノードを追加できます。表示される円をドラッグ&ドロップすることで経由点を設定できます。※ただし詳細設定の経由地点を回る順の項目で最適な順を選択した場合は、ノードを追加できません。設定した地点を削除するときは、マーカー上で右クリックし、「この地点を削除する」を選択します。すべての地点を削除するときは、右クリックメニューから「地点をクリアする」を選択します。出発地点または到着地点のいずれかを削除すると、経路は削除されます。右クリックメニューで「詳細設定」を選択すると、詳細設定メニューが開きます。設定できる項目は以下の通りです。使用しない:フェリーを使用しない経路(フェリーでしか行けない場所はエラー)。しない:有料道路を使用しない経路(有料道路でしか行けない場所はエラー)。設定を変更し、「設定して閉じる」または「再探索」ボタンを押すと、設定が反映されます。「再探索」の場合は即時に経路探索が行われます。GeoXml切り替えプラグイン(Y.GeoXmlPlugin)GeoXml切り替えプラグインは、店舗や拠点の集積度や統計情報などをヒートマップ表現で地図上に表示する機能を提供します。この機能は、GeoXml切り替えプラグイン(Y.GeoXmlPlugin)をY.Mapオブジェクトに追加することで利用できます。プラグインを追加すると、ヒートマップコントロールが追加され、ヒートマップ/アイコンの切り替えが行えるようになります。クトに追加することでも利用できます。いずれの機能もYDF形式のXMLが取得できるURLを指定する必要があります。GeomertyのTypeがpointのものだけ有効となりますのでご注意ください。※対応ズームレベルは4~20です。GeoXml切り替えプラグイン//宣言済みのMapオブジェクト(変数名map)にGeoXml切り替えプラグインを設定するサンプルです。第1引数にはYDF形式のXMLが取得できるURLを指定します。第2引数にはヒートマップ、アイコンの表示モードのオプションを指定します。addPluginでMapオブジェクトに追加します。ヒートマップレイヤー//宣言済みのMapオブジェクト(変数名map)にヒートマップレイヤーを設定するサンプルです。GeoXmlHeatmapLayer(ヒートマップ表示用レイヤー)を初期化します。第1引数にはYDF形式のXMLが取得できるURLを指定します。addLayerでMapオブジェクトに追加します。ヒートマップを描画します。GeoXml切り替えプラグインを利用するサンプルページはこちらになります。このサンプルでは、静的なYDF形式のXMLファイルを用意して引数のurlとして指定しています。他にも、YDF形式のXMLを取得する手段として、例えばローカルサーチAPIのレスポンスを指定することが可能です。組み込みで用意されているプラグインと同様に、APIに対する処理をJavaScriptで記述し、プラグインとして公開することが可能です。下記のインターフェースを持つメソッドを実装する必要があります。ymap)Y.Map.addPluginの実行時に呼び出されます。引数として、プラグインと関連付けられたY.Mapオブジェクトが渡されます。Y.Plugin.unload()Map.removePluginの実行時に呼び出されます。//地図上にアイコンを表示するHelloプラグインを作成します。{});//loadメソッドを実装します。呼び出されたときに地図上にマーカー追加し情報ウィンドウを表示します。this.marker.openInfoWindow('Hello!');};//unloadメソッドを実装します。地図上に追加していたマーカーを削除します。作成したプラグインはY.Map.addPluginの引数に渡すことで有効化されます。このとき、実装したloadメソッドに引数としてY.Mapオブジェクトが渡されます。有効化されたプラグインを無効にするにはY.Map.removePluginを実行します。このとき、実装したunloadメソッドが呼ばれます。独自プラグインを作成して利用するサンプルページはこちらになります。