Документация MapiaAPI

Документация API Mapia Для того чтобы посетители вашего сайта смогли увидеть карту на вашей странице у них должен быть установлен Flash Player 9.0.115 и выше, а также они должны пользоваться следующими браузерами: Opera 9 и выше; FireFox 2 и выше; Internet Explorer 6 и выше; Safari 3 и выше; Google Chrome. После того, как вы получите ключ [/apikeys/new] к API Mapia, вы сможете интегрировать карту Mapia на свой сайт следующим образом: Установка Для того, чтоб пользоваться MapiaAPI, необходимо получить ключ по адресу: http://mapia.com.ua/apikeys/new В поле хост нужно ввести хост сайта на котором вы хотите использовать API. Для хостов localhost и 127.0.0.1 получать ключ не обязательно. После получения ключа достаточно подключить в документ скрипт: Простейший пример использования MapiaAPI Конструктор Mapia(containerId, options) containerId - DomID элемента в котором будет находиться объект карты. Размеры этого элемента задают размеры карты. options - параметр типа Object с такими аттрибутами: zoom - начальный уровень приближения карты. Число от 6(далеко) до 18(близко) center - точка в которую будет цетрирована карта. Это может быть либо объект с аттрибутами lat, lon - где lat и lon - это широта и долгота соответственно; либо строка c почтовым адресом. lang - язык на котором будут отображаться названия на карте (доступные варианты "ru" и "ua") Пример 1. var map = new Mapia('mapContainer', {center:'Смольная 9', zoom:15}) Пример 2. var map = new Mapia('mapContainer', {center:{lat:50.45759, lon:30.38898}, zoom:15}) Методы getCenter Возвращает координаты центра карты в объекте {lat:... , lon:...}. Этот метод вернет null, если карта еще не инитиализирована setCenter(latlonOrString) Задает координаты карты. Как и в конструкторе - это может быть latlon объект или строка с адресом. getZoom Возвращает зум карты setZoom(number) Задает зум карты. Возможные значения - от 6 до 18. addMarker(markerId, latlonOrString, popupData) Устанавливает маркер с идентификатором markerId в место у казаное координатами или адресом во втором параметре. Если такой идентификатор уже был использован другим маркером, маркер не добавится. Объект popupData может содержать следующие атрибуты: title - заголовок. Отображается в подсказке при наведении на маркер, и крупными букавами в попапе. category_name - Отображается в попапе над заголовком. logo - url логотипа, картинка 100x100. icon_url - url иконки маркера. address - адрес. phone - телефон. url - адрес веб-сайта. Протокол в url должен быть указан обязательно. Например: http://example.com note - текст, который отображается в попапе под адресом, телефоном, е-мейлом. description - текст в попапе, который можно увидить нажав кнопку “подробнее”. nopopup - true|false . Установите true если не хотите чтоб отображался попап при клике на маркер. Внимание! Есть 3 распространенные ошибки, при добавлении маркера: не указан icon_url , или указан относительный урл, который интерпритируется относительно http://mapia.com.ua/ , а не относительно урла страницы, в которую включена карта указан не уникальный идентификатор маркера На сервере, с которого скачивается иконка для маркера, не лежит файл crossdomain.xml Возможное решение проблемы: иконки для маркеров разместить на своем сервере, и в корень положить файл crossdomain.xml например такого содержания: Пример всегда можно посмотреть здесь: http://mapia.com.ua/crossdomain.xml Это относится только к иконкам маркера, и не относиться к логотипам. removeMarker(markerId) Удаляет маркер с указаным идентификатором. addPlugin(pluginData) Устанавливает плагин на карту. Плагином может быть флеш-объект (.swf) или картинка. Объект pluginData может содержать следующие атрибуты: id - Идентификатор плагина. lon - Долгота точки, к которой будет привязан плагин (верхний левый угол). lat - Широта точки, к которой будет привязан плагин (верхний левый угол). url - Веб-адрес, по которому находится плагин. min_zoom - Минимальное значение зума, на котором виден плагин. max_zoom - Максимальное значение зума, на котором виден плагин. width - Ширина плагина. height - Высота плагина.