AMap

Třída s jejíž pomocí lze udělat z elementu DIV mapu. Všechny události v options (onXXX) lze přidat také pomocí addEvent. Map může být na stránce více.

Arguments

clip	div do kterého se mapa vykreslí. Lze předat element nebo jeho Id.
options	volitelné parametry, object literal

Options

draggingEnabled	povolí dragování mapy, výchozí nastavení je true
rectangleSelectionEnabled	povolí výběrový obdélník, výchozí nastavení je true
zoomingEnabled	povolí změnu měřítka mapy, výchozí nastavení je true
sharpMapMoveEnabled	aktivuje ostřejší pohyb mapy, výchozí nastavení je false
smoothZoomEnabled	povolí animovanou změnu měřítka, výchozí nastavení je true
mapTypes	pole objektů AMapType, tedy různých typů mapových podkladů
layers	pole objektů AMapType, to samé jako mapTypes. Layers jsou překryvné vrstvy, které se vykreslují nad aktuálním mapovým (nebo jiným) podkladem. Maximální počet layerů jsou tři. První bude vykreslen jako nejspodnější, přesto bude překrývat aktuální AMapType.
defaultMapType	výchozí typ mapy, nastavuje se podle AMapType.displayName. Neexistuje-li, jako vychozí se nastaví první AMapType
mouseWheelEnabled	povolí kolečko myši, výchozí nastavení je true
showAtlasLogo	zobrazí Atlas logo, výchozí nastavení je true
wheelSense	citlivost kolečka myši v ms, výchozí nastavení je 75ms
contextMenuItems	položky pro kontextové menu, tedy pole objektů typu AContextMenuItem
fixEolas	aktivuje fix pro Internet Explorer, který způsobí, že na Flash není třeba klikat 2x (první je aktivace)
mapCursor	css styl pro kurzor nad mapou v klidovém stavu
mapDragCursor	css styl pro kurzor nad mapou při dragování

Events

onInitEnd	konec inicializace mapy. Argument: map
onLoadMapsBefore	vyhozeno na začátku metody AMap.loadMaps, předané argumenty handleru jsou: center, scaleOrScaleIdx, mapName, mouseCenter
onLoadMapsSuccess	vyhozeno na konci metody AMap.loadMaps, v případě že požadovaná mapa existuje
onScaleChanged	došlo ke změně měřítka. Argument: map
onScaleChangedFailed	nedošlo ke změně měřítka. Argument: map
onMapTypeChanged	došlo ke změně typu mapy. Argument: map
onMouseMove	událost se vyhazuje při pohybu myši. Argumenty: AGeoPoint - pozice kurzoru, e - DOM event, te lze použít například pro zablokování propagace události
onDragStart	po začátku dragování, tedy mousedown. Argument: map
onDragEnd	na konci dragování, tedy mouseup. Argument: map
onClick	tato událost se vyhazuje při kliku na mapu. Svému handleru předává dva argumenty. První je instance objektu overlay (např. AMarker), kliklo-li se na nějaký. Druhý argument je AGeoPoint, souřadnice místa kliku. Souřadnice jsou upraveny (tedy pro IE) tak, aby odpovídali přesně špičce kurzoru.
onRightClick	událost vyhozena při kliku pravým tlačítkem myši na mapu. Pozor, pod Operou nefunguje. Argumenty předané handleru jsou stejné jako u události onClick.
onMoveStart	událost vyhozena na začátku animovaného pohybu
onMoveEnd	událost vyhozena na konci animovaného pohybu
onUpdateEnd	událost vyhozena na konci update mapy, tj. na konci: dragování, animace, zoomu a loadmaps.
onResizeEnd	speciální událost vyhazovaná na konci změny velikosti okna prohlížeče (50ms timeout)
onRegisterLayers	událost vyhozena v případě volání metody AMap.registerLayers
onZoomStart	událost vyhozena při startu animovaného zoomu, argumenty předan0 handleru: index požadovaného měřítka, délka animace v ms
onZoomEnd	událost vyhozena na konci zoomování, tedy animované změny měřítka, argument předaný handleru je odkaz na mapu
onContextMenuShowed	událost vyhozena při kliku pravým tlačítkem myši na mapu a v případě, že je nadefinováno kontextové menu. Tak lze třeba změnit obsah kontextového menu.

Příklad

var mainMap = new AMap("mainmap", {
    draggingEnabled : false,
    zoomingEnabled : false
});

Summary

AMap	Třída s jejíž pomocí lze udělat z elementu DIV mapu.
Functions
checkAMapCompatibility	Vrátí true, v případě že clientský prohlížeč zvládá běh AMapy API.
getVersion	Vrací aktuální verzi AMapy API.
getActionLayer	Vrací speciální layer, který váže události pro plochu mapy (nikoliv tedy pro overlaye, nebo map party).
getClipSize	Vrací rozměry divu, který ořezává mapu např.
resetClipSize	Při manuální změně rozměrů clipu (ořezového divu), je nutno zavolat tuto metodu.
loadMaps	Metoda nahraje a zobrazí mapu dle zadaných argumentů (střed, měřítko, typ mapy).
getMode	Vrátí aktuální stav mapy v enumeraci AMapMode.
getMapTypes	Vrátí JSON objekt popisující mapové podklady.
getMapTypeByDisplayName	Najde a vrátí AMapType podle jeho jména AMapType.displayName.
hasMapTypeThisScale	Zjistí, jestli typ mapy s předaným displayName obsahuje absolutní měřítko (přesná shoda), nebo meřítko s indexem.
getCurrentMapType	Vrátí aktuální typ mapy AMapType, což je objekt popisující celý typ mapy, např.
getCurrentMapTypeName	Vrátí aktuální AMapType.displayName, např.
getCurrentMapTypeIdx	Vrátí index aktuálního AMapType v poli všech mapových typů.
setMapType	Přepne mapový podklad, pokud tedy požadovaný podklad má stejné měřítko <ScaleInfo.scale>.
registerLayers	Metoda slouží pro registraci překryvných mapových vrstev.
getLayers	Metoda vrací zaregistrované překryvné mapové vrstvy.
update	Překreslí mapu.
getContextMenuPosition	Vrátí pozici, na které bylo stisknuto pravé tlačítko myši těsně před zobrazením kontextového menu.
setContextMenuItems	Nastaví položky kontextového menu
getPxCanvasSize	Vrací v ASize velikost aktuální mapy v pixelech
getGeoCanvasSize	Vrací v AGeoBounds plochu aktuálního měřítka mapy.
getGeoBounds	Vrací v AGeoBounds velikost aktuální viditelné části mapy, tedy mapy ohraničené výřezovým oknem.
getRealPxBounds	Vrací v ABounds velikost aktuální viditelné části mapy.
getPxClipTopLeftCorner	Vrací pozici typu APoint levého horního rohu clipu (v px od levého horního rohu canvasu).
getRealPxClipTopLeftCorner	Vrací pozici typu APoint leveho horniho rohu clipu (v px od leveho horniho rohu canvasu).
getRealPxFromGeo	Funkce na přepočet souřadnice z AGeoPoint do APoint, tedy PX.
getGeoFromRealPx	Funkce na přepočet souřadnice z APoint do AGeoPoint.
getGeoFromPx	Funkce na přepočet souřadnice z APoint do AGeoPoint.
getPxFromGeo	Funkce na přepočet souřadnice z AGeoPoint do APoint, tedy PX.
getPxCenter	Vrací aktuální střed map v jednotkách pixelu APoint.
getRealPxCenter	Vrací aktuální střed map v jednotkách pixelu APoint.
getGeoCenter	Vrací aktuální střed map v AGeoPoint.
getPxMousePos	Vrací aktuální pozici myšky v APoint
getRealPxMousePos	Vrací aktuální pozici myšky v APoint v pixelech.
getGeoMousePos	Vrací aktuální pozici myšky v AGeoPoint
setBestZoomAndCenter	Nalezne a nastaví nejvhodnější měřítko a střed mapy tak, aby se zobrazili pokud možno všechny body.
getCurrentScaleInfo	Vrací aktuální AScaleInfo, objekt komplet popisující aktuální měřítko.
getCurrentScaleIdx	Vrací aktuální index měřítka v poli měřítek (které lze získat pomocí AMap.getScaleInfos.
getCurrentScale	Vrací aktuální absolutní měřítko.
getScaleInfos	Vrátí pole měřítek aktuálního typu mapy.
getScaleInfoByIdx	Vrátí AScaleInfo z pole aktuálního typu mapy.
getNearestScaleIdx	Metoda na aktuálním (nebo předaném) typu mapy nalezne stejné, nebo nejbližší měřítko a vrátí jeho index.
setCursor	Nastaví typ myšího kurzoru nad mapou.
setPosition	Napozicuje element dle
moveTo	Přesune střed mapy do zadaných souřadnic.
moveToShowAll	Posune mapu tak, aby se předaný element byl na mapě viditelný pokudmožno celý.
moveDirection	Šoupne mapou v definovaném směru o zhruba 1/3 rozměru mapy.
slideDirection	Nastartuje automatický posun mapy v definovaných směrech.
slideStop	Zastaví automatický posun mapy
savePosition	Uloží aktuální měřítko, typ mapy a pozici, pro následné použití v metodě AMap.returnToSavedPosition.
returnToSavedPosition	Obnoví stav mapy uložené metodou AMap.savePosition.
zoomIn	Přiblíží mapu o jeden krok
zoomOut	Oddálí mapu o jeden krok
zoomTo	Provede zoom, tedy změnu měřítka mapy.
addMapPart	Přidá do mapy potomka AMapPartBase.
addOverlay	Metoda slouží k přidání libovolného objektu, který implementuje rozhraní AOverlay na mapu.
addMarkers	Metoda slouží k super rychlému přidání předem vytvořeného pole značek, tedy objektů typu AMarker.
removeOverlay	Odstraní objekt typu AOverlay z mapy
removeAllOverlays	Odstraní všechny objekt typu AOverlay z mapy, kromě bubliny
removeAllMarkers	Odstraní z mapy všechny objekty typu AMarker
hideOverlayPanes	Schová všechny objekty na mapě.
showOverlayPanes	Zobrazí všechny objekty na mapě.
getPane	Vrací div / pane dle enumerace AMapPane.
showInfoBubble	Info bublina se zobrazuje v levém dolním rohu a slouží k zobrazeních kratších informativních textů.
closeInfoBubble	Explicitně schová info bublinu.
showBubble	Zobrazi bublinu, tedy zavolá metodu ABubble.show.
closeBubble	Schova bublinu.
getBubble	Vrátí bublinu.
AContextMenuItem	Třída s jejíž pomocí lze nadefinovat položky kontextového menu.

AContextMenuItem

Třída s jejíž pomocí lze nadefinovat položky kontextového menu.

Arguments

itemHTML	text, nebo HTML string pro položku v menu
onClick	reference na metodu, která se zavolá na klik
imageSrc	obrázek, gif nebo png který se zobrazí před položkou
imageWidth	šířka obrázku v px

Příklad

var menu = [
    new AContextMenuItem('Označit místo', function() {alert('ahoj')}),
    new AContextMenuItem('Jet z', function() {alert('ahojf')}),
    new AContextMenuItem('Jet do', function() {alert('ahojf')}),
    new AContextMenuItem('GPS', function() {alert('ahojf')}),
    new AContextMenuItem('Najdi nejbližší...', function() {alert('ahojf')}),
    new AContextMenuItem('Uložit mapu jako obrázek', function() {alert('ahojf')})
];
this.map = new AMap("map", {
    contextMenuItems: menu
});

AMap

Arguments

Options

Events

Příklad

Functions

checkAMapCompatibility

getVersion

getActionLayer

Returns

getClipSize

Returns

resetClipSize

loadMaps

Arguments

Příklad

getMode

Return

getMapTypes

getMapTypeByDisplayName

Arguments

Return

hasMapTypeThisScale

Arguments

Returns

getCurrentMapType

Returns

getCurrentMapTypeName

getCurrentMapTypeIdx

setMapType

Arguments

registerLayers

Arguments

getLayers

Arguments

update

Argument

getContextMenuPosition

Returns

setContextMenuItems

Arguments

getPxCanvasSize

Returns

getGeoCanvasSize

Arguments

Returns

getGeoBounds

Returns

getRealPxBounds

Returns

getPxClipTopLeftCorner

Returns

getRealPxClipTopLeftCorner

Returns

getRealPxFromGeo

Arguments

Returns

getGeoFromRealPx

Arguments

Returns

getGeoFromPx

Arguments

Returns

getPxFromGeo

Arguments

Returns

getPxCenter

Returns

getRealPxCenter

Returns

getGeoCenter

Returns

getPxMousePos

Returns

getRealPxMousePos

getGeoMousePos

setBestZoomAndCenter

Arguments

getCurrentScaleInfo

getCurrentScaleIdx