Въведение
N MAPS API обикновено се интегрира в уеб страници, в които се показва информация за географски локации.
JavaScript код трансферира информация относно локации и символи така, че да могат да бъдат показани на картата.
Когато потребителят натисне върху символ, се извиква друг JavaScript код, така че върху уеб страницата да се извършат необходимите действия за показване на по детайлна информация.
Нормално, освен символи на картата се показват и бутони /контроли/, позволяващи да се извършват очаквани действия върху картата като мащабиране и местене.
N MAPS API обикновено се интегрира в уеб страници, в които се показва информация за географски локации.
JavaScript код трансферира информация относно локации и символи така, че да могат да бъдат показани на картата.
Когато потребителят натисне върху символ, се извиква друг JavaScript код, така че върху уеб страницата да се извършат необходимите действия за показване на по детайлна информация.
Нормално, освен символи на картата се показват и бутони /контроли/, позволяващи да се извършват очаквани действия върху картата като мащабиране и местене.
Управление
Натискането с мишката върху картата и преместването на курсора води промяна на видимата картова информация. За това действие също така могат да се ползват бутоните за местене и мащабиране.
Когато се натисне върху символ се извиква предварително дефиниран JavaScript метод, чрез който може да се промени съдържанието на уеб страницата или да се покаже допълнителна информация за
натиснатия символ. Допълнително, може да се изпълни и метод, когато потребителят спре да взимодейства с картата или когато натисне с мишката където и да е по картата.
Натискането с мишката върху картата и преместването на курсора води промяна на видимата картова информация. За това действие също така могат да се ползват бутоните за местене и мащабиране.
Когато се натисне върху символ се извиква предварително дефиниран JavaScript метод, чрез който може да се промени съдържанието на уеб страницата или да се покаже допълнителна информация за
натиснатия символ. Допълнително, може да се изпълни и метод, когато потребителят спре да взимодейства с картата или когато натисне с мишката където и да е по картата.
Предпоставки
За да можете да използвате картова информация във вашият сайт, необходимо е първо да заредите NMAPS API. За да направите това, сложете в секция <head> следния код :
NMAPS API изисква да съществува HTML div елемент, който ще служи като контейнер на картова информация. Съдържанието на този контейнер се изтрива, картовата информация се зарежда и показва.
Пример за подобен контейнер е следният код:
За да можете да използвате картова информация във вашият сайт, необходимо е първо да заредите NMAPS API. За да направите това, сложете в секция <head> следния код :
<script src="http://maps.naviteq.net/map.cgi?api=v3&key=abcdef" type="text/javascript"></script>
Като замените abcdef с вашият ключNMAPS API изисква да съществува HTML div елемент, който ще служи като контейнер на картова информация. Съдържанието на този контейнер се изтрива, картовата информация се зарежда и показва.
Пример за подобен контейнер е следният код:
<div style="width: 800px; height: 600px;" id="mapdiv"></div>
Където, id атрибутът на контейнера задължително трябва да бъде попълнен.
Изисквания
Поддържат се следните минимални версии на браузъри:
Поддържат се следните минимални версии на браузъри:
- IE 6.0+
- Firefox 1.0+
- Safari 2.0+
Конструиране на карта
Картата се конструира асинхронно чрез използване на следния код : new NMaps(params).
Тук параметърът params съдържа именовани данни, необходими за конструирането.
Картата се конструира асинхронно чрез използване на следния код : new NMaps(params).
Тук параметърът params съдържа именовани данни, необходими за конструирането.
Параметри за конструирането на карта
Style обект
Обект, описващ стил на елемент със следните полета / характеристики
Базови функции за работа с карта
Контроли за управление на картата
Методи за заявки и управление на географските данни, които да се показват на екрана.
Геокодиране
Геокодирането е процес по конвертиране на адрес
(например: София 1000, ул. Иван Денкоглу 15А) в точка с определени координати на местоположение (например: Lat: 42 deg. 41 min. 38 sec., Lon. 23deg. 19min. 11 sec). По този начин клиентите могат да сложат маркер или символ върху картата.
Reverse Geocoding обратно превръща географски координати в нормално читаем адрес.
Вграденият геокодер се използва чрез функцията getAddressCoords. Функцията приема следните параметри:
И връща string от типа "1, 0,1,4733414.63162992,198540.404474237,ОБЛ. СОФИЯ-ГРАД,ОБЩИНА СТОЛИЧНА,ГР. СОФИЯ,,УЛ. ИВАН ДЕНКОГЛУ,15,,А," който е със следния формат:
(например: София 1000, ул. Иван Денкоглу 15А) в точка с определени координати на местоположение (например: Lat: 42 deg. 41 min. 38 sec., Lon. 23deg. 19min. 11 sec). По този начин клиентите могат да сложат маркер или символ върху картата.
Reverse Geocoding обратно превръща географски координати в нормално читаем адрес.
Вграденият геокодер се използва чрез функцията getAddressCoords. Функцията приема следните параметри:
И връща string от типа "1, 0,1,4733414.63162992,198540.404474237,ОБЛ. СОФИЯ-ГРАД,ОБЩИНА СТОЛИЧНА,ГР. СОФИЯ,,УЛ. ИВАН ДЕНКОГЛУ,15,,А," който е със следния формат:
Мащабиране и местене на картата
Символи
Към параметрите описващи символа, могат да бъдат подадени и други параметри, които могат да се получат и обработят при събитие symbolClicked.
Параметри за начин на осветяване на символ
Незадължителни параметри, уточняващи начина на осветяване на всеки символ.
Размер на карта
Събития
Това са методите за обратно извикване (callback) на обект изпълним по време на инициализацията му. Необходимо е дефинирате само методите, които са ви нужни.
Създаване на обекти
Това са методите за създаване на обекти
Управление на обекти
Това са методите за създаване на обекти
Интересни точки (POI)