среда, 16 сентября 2009 г.

Начинаем изучать API Яндекс.Карт

С этой заметки я начинаю цикл публикаций по работе с API Яндекс.Карт.

Раздел на сайте Яндекса – http://api.yandex.ru/maps/ с подробным описанием.

Для того чтобы использовать API Яндекс.Карт на своем сайте необходимо получить уникальный ключ.

Для этого Вы должны:

иметь логин и пароль на Яндексе и быть авторизованным;

ознакомиться и принять условия Пользовательского соглашения;

указать URL вашего сайта в регистрационной форме.

Если Вы не были ранее зарегистрированы на Яндексе , то в начале Вам необходимо пройти процедуру регистрации по адресу http://passport.yandex.ru/passport?mode=register

После этого Вы должны выполнить процедуру авторизации на сайте Яндекса (с этого шага следует начить и всем тем, кто уже раннее был зарегистрирован там).

Затем Вы должны посетить страницу по адресу http://api.yandex.ru/maps/form.xml для получения ключа

И если Вы авторизованы то увидите форму для получения ключа.

В первой графе необходимо указать адрес сайта на котором будут исользоваться Яндекс.Карты.

Лучше всего в качестве адреса сайта указывать только его домен (например, mysayt.ru).

Тогда ключ, зарегистрированный на отдельный домен, будет действителен для всех url внутри этого домена и для специальных поддоменов (например для “www”).

Ключ, зарегистрированный на домен http:// mysayt.ru /, будет действителен для:

http:// mysayt.ru /

http://www.mysayt.ru /

http://www.mysayt.ru /page/

http://host1.mysayt.ru /

http://host2.mysayt.ru /page/

Обратите внимание, что ключ, зарегистрированный на домен http://www. mysayt.ru / будет действителен только для домена http://www. mysayt.ru и его разделов (например, http://www. mysayt.ru /page/).

На локальном компьютере с доменом localhost можно использовать любой ключ.

Далее нужно прочитать и согласится с условиями пользовательского соглашения.

Нажать на кнопку Получить API-ключ.

После этого Вы получите с генерированный ключ и простой пример использования сервиса API Яндекс.Карт с Вашим ключом.

Например:

Ключ: AKgqHEkBAAAA-WzMYwIAeAeamm8ETZZZpdfp2R07eIuGyX4AAAAAAAAAAACjUCDoHIHZJ2pcl5mSL1zWVp2Myw==

Пример кода:

<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN”

“http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”>

<html xmlns=”http://www.w3.org/1999/xhtml”>

<head>

<meta http-equiv=”Content-Type” content=”text/html” />

<script src=”http://api-maps.yandex.ru/1.1/?key=

AKgqHEkBAAAA-WzMYwIAeAeamm8ETZZZpdfp2R07eIuGyX4AAAAAAAAAAACjUCDoHIHZJ2pcl5mSL1zWVp2Myw==”

type=”text/javascript”></script>

<script type=”text/javascript” charset=”utf-8″>

var map;

function init () {

map = new YMaps.Map( document.getElementById(”YMapsID”) );

map.setCenter(new YMaps.GeoPoint(44.0,56.32811), 13,

YMaps.MapType.MAP);

};

</script>

</head>


<body onload=”init();”>

<div id=”YMapsID” style=”height:400px; width:600px;”></div>

</body>

</html>

Вы можете использовать данный пример кода для тестирования работы. При необходимости изменить координаты центра карты (44.0,56.32811) и уровень масштаба (13).

Все ранее полученные Вами ключи Вы всегда можете узнать на специальной странице http://api.yandex.ru/maps/keyslist.xml

Для тестирования и выполнения различных упражнений с API Яндекс.Карт на домашнем компьютере Вам будет необходимо установит локальный веб-сервер. Как это проще всего сделать я описал в специальной заметке в разделе База знаний.