С этой заметки я начинаю цикл публикаций по работе с 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 Яндекс.Карт на домашнем компьютере Вам будет необходимо установит локальный веб-сервер. Как это проще всего сделать я описал в специальной заметке в разделе База знаний.