地図を作成します。
※) 地図画像の取得には mapcache.e-map.ne.jp ドメインへ接続します。
地図画像が表示されない場合、ご利用の環境に合わせて接続制限設定を見直しください。
※) 地図画像の取得をするURLは予告なく変更されます。
取得したURLの保持はお控えください。
※) 使用される測地系は日本測地系です。世界測地系を使用してご利用の際は
Webメルカトルを使用するか、測地系変換をご利用下さい。
引数 | プロパティ | タイプ | デフォルト | 説明 |
dom | - | DOM | - | 地図を表示するdiv要素(指定するdivはwidth、heightが必須、 ただしスタイルシートでの設定は不可) |
options | latlon | ZDC.LatLon | 東京駅 | 地図の中心点の緯度経度 実装例 |
zoom | number | 0(最小ズーム) | 地図の縮尺レベル 実装例 | |
mapType | string | ZDC.MAPTYPE_DEFAULT | マップタイプ 実装例 | |
zoomRange | array(number) | 全て(マップタイプによる) | 縮尺番号の配列 実装例 | |
wheelType | number | 1 | マウスホイールの動作を指定する。 0:引く場合ズームイン 1:引く場合ズームアウト 2:動作を無効にする 3:動作を無効にする(ホイールイベントはbodyまで伝わる) 実装例 |
|
zoomCenter | boolean | false | true:地図の中心点の緯度経度を変えずに縮尺レベルが変更 される false:マウスポインタ位置の緯度経度を変えずに縮尺レベル が変更される 実装例 |
|
scale | number | 1 | 地図を表示する大きさを変更する (未指定のときの表示サイズを1としたときの相対値) |
ウィジットを追加します。
引数 | タイプ | 説明 |
widget | ウィジット | 全てのウィジットオブジェクト |
ドラッグによる地図の移動を無効にします。
実装例
ドラッグによる地図の移動を有効にします。
実装例
配列として指定された地点が全て表示できる最適な縮尺レベル、中心点の緯度経度を取得します。
該当する縮尺レベルがなければnullを返却します。
このメソッドで取得した縮尺レベル、緯度経度を利用して地図を表示すると指定した点列が全て含まれます。
引数 | プロパティ | タイプ | デフォルト | 説明 |
latlons | - | array(ZDC.LatLon) | - | 緯度経度の配列 |
options | fix | boolean | false | true:戻り値のlatlonは現在の地図の中心点の緯度経度と同じ false:戻り値のlatlonは、latlonsで指定された点列が全て含まれる 最小の矩形の中心点 |
戻り値
プロパティ | タイプ | 説明 |
zoom | number | 縮尺レベル |
latlon | ZDC.LatLon | 指定された点列が全て含まれる矩形の中心点(fixの値によって異なる) |
地図領域(コンストラクタで指定されたdivの領域)の最大・最小緯度経度を取得します。
実装例
地図領域の左上端をtop=0,left=0として指定されたZDC.LatLonをZDC.TLに変換します。
引数 | タイプ | 説明 |
latlon | ZDC.LatLon | 緯度経度 |
保存した緯度経度を地図の中心にします。
setHome()を実行していない場合はコンストラクタで指定した緯度経度を地図の中心にします。
引数 | タイプ | 説明 |
latlon | ZDC.LatLon | 緯度経度 |
ピクセル単位で指定した値だけ地図の中心点を移動させます。
実装例
引数 | タイプ | 説明 |
x | number | 経度方向への移動量をピクセル単位で指定(指定できる値は-10000から10000) |
y | number | 緯度方向への移動量をピクセル単位で指定(指定できる値は-10000から10000) |
コンストラクタで指定したdiv要素のstyleの変更を地図に反映させます。
実装例
ウィジットを削除します。
一度削除されたwidgetは再度addWidget()出来ません。
引数 | タイプ | 説明 |
widget | ウィジット | 全てのウィジットオブジェクト |
指定された緯度経度を保存します。 指定がない場合は地図の中心点の緯度経度を保存します。
引数 | タイプ | 説明 |
latlon | ZDC.LatLon | 緯度経度 |
地図を印刷に適したページにします。
次のウィジットは非表示になります。
・コントロール
・ユーザコントロール
・中心点画像
・吹き出し
・ユーザウィジット
・スタティックユーザウィジット
・サブマップ
引数 | タイプ | 説明 |
zoom | number | 縮尺レベル |
地図領域の左上端をtop=0,left=0として指定されたZDC.TLをZDC.LatLonに変換します。
引数 | タイプ | 説明 |
tl | ZDC.TL | トップ、レフト値 |
地図を1レベルズームインします。緯度経度の指定がない場合は、現在の地図の中心点にズームインします。
引数 | プロパティ | タイプ | 説明 |
options | latlon | ZDC.LatLon | ズームの中心となる緯度経度 |
地図を1レベルズームアウトします。緯度経度の指定がない場合は、現在の地図の中心点からズームアウトします。
引数 | プロパティ | タイプ | 説明 |
options | latlon | ZDC.LatLon | ズームの中心となる緯度経度 |
地図領域の大きさを取得します。
※Android OS搭載端末では正常に動作しないことがあります。
マウスホイール動作、スマートフォン・タブレットのピンチイン/ピンチアウト動作による縮尺レベルの変更を有効にします。
マウスホイール動作、スマートフォン・タブレットのピンチイン/ピンチアウト動作による縮尺レベルの変更を無効にします。
表示する地図を定数で指定します。
マップタイプごとのピクセルあたりの緯度経度量
タイルサイズについて
実装例
マップタイプ変更時の注意点
マップタイプ | 説明 |
ZDC.MAPTYPE_DEFAULT | 標準の地図です。縮尺番号は「5~17」の値が指定できます。 日本国外の地域ではアイコンや吹き出しなどが正しく重畳されない可能性があります。 |
ZDC.MAPTYPE_COLOR | いつもNAVI開発キットサービス API ver.1で利用していた地図です。 縮尺番号は「1~18」の値が指定できます。 |
ZDC.MAPTYPE_NOICON | 企業アイコンがない地図です。 縮尺番号は「1~18」の値が指定できます。 |
ZDC.MAPTYPE_MOBILE | 通信速度が遅い環境での利用を想定し、 ファイルサイズが小さくなるようなデザインを採用しています。 縮尺番号は 「1, 2, 3, 4, 5, 6, 7, 9, 10, 11, 12, 13, 14, 16, 18」の値が指定できます。 |
ZDC.MAPTYPE_TOWNWALK | 店舗案内などの徒歩での利用に最適なデザインの地図です。詳細 縮尺番号は「1~18」の値が指定できます。 |
ZDC.MAPTYPE_MONOCHRO | モノクロの地図です。 縮尺番号は「5~17」の値が指定できます。 日本国外の地域ではアイコンや吹き出しなどが正しく重畳されない可能性があります。 |
ZDC.MAPTYPE_FLAT_COLOR | フラットデザインの地図です。 縮尺番号は「1~18」の値が指定できます。 |
ZDC.MAPTYPE_FLAT_LV20 | 縮尺番号20に対応したフラットデザインの地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_FLAT_LV20_COMMONICON | 縮尺番号20に対応したフラットデザインの企業アイコンがない地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_NIGHT | 夜のデザインの地図です。 縮尺番号は「1~18」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRESOLUTION | 高解像度ディスプレイ対応のフラットデザインの地図です。 縮尺番号は「3~16」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_LV18 | 縮尺番号18に対応した高解像度ディスプレイ対応のフラットデザインの地図です。 縮尺番号は「3~18」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_DEFAULT | 高解像度ディスプレイ対応の地図です。 縮尺番号は「3~16」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_NIGHT | 高解像度ディスプレイ対応の夜のデザインの地図です。 縮尺番号は「3~16」の値が指定できます。 |
ZDC.MAPTYPE_BLANK | 注記がない地図です。 縮尺番号は「5~17」の値が指定できます。 |
表示する地図を定数で指定します。
実装例
マップタイプ | 説明 |
ZDC.MAPTYPE_ALPHABETSV2 | 注記が英字表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_KANTAI | 注記が中国語簡体表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_HANTAI | 注記が中国語繁体表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_HANGEUL | 注記が韓国語表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_THAI | 注記がタイ語表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_ITALIAN | 注記がイタリア語表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_INDONESIAN | 注記がインドネシア語表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_SPANISH | 注記がスペイン語表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_GERMAN | 注記がドイツ語表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_FRENCH | 注記がフランス語表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_VIETNAMESE | 注記がベトナム語表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_PORTUGUESE | 注記がポルトガル語表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_MALAYSIAN | 注記がマレー語表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_RUSSIAN | 注記がロシア語表記の地図です。 縮尺番号は「1~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_ALPHABETS | 高解像度ディスプレイ対応の注記が英字表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_KANTAI | 高解像度ディスプレイ対応の注記が中国語簡体表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_HANTAI | 高解像度ディスプレイ対応の注記が中国語繁体表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_HANGEUL | 高解像度ディスプレイ対応の注記が韓国語表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_THAI | 高解像度ディスプレイ対応の注記がタイ語表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_ITALIAN | 高解像度ディスプレイ対応の注記がイタリア語表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_INDONESIAN | 高解像度ディスプレイ対応の注記がインドネシア語表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_SPANISH | 高解像度ディスプレイ対応の注記がスペイン語表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_GERMAN | 高解像度ディスプレイ対応の注記がドイツ語表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_FRENCH | 高解像度ディスプレイ対応の注記がフランス語表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_VIETNAMESE | 高解像度ディスプレイ対応の注記がベトナム語表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_PORTUGUESE | 高解像度ディスプレイ対応の注記がポルトガル語表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_MALAYSIAN | 高解像度ディスプレイ対応の注記がマレー語表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |
ZDC.MAPTYPE_HIGHRES_RUSSIAN | 高解像度ディスプレイ対応の注記がロシア語表記の地図です。 縮尺番号は「3~20」の値が指定できます。 |