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

  • Гость: Всё сделал, так как описано - на домашнем компьютере карта не работает.
  • Гость: Эта заметка написана в марте 2009 года, сейчас используется более новая версия API. Кроме того, при вставки в статью произошли замены кавычек на другие символы. Код примера поправил, теперь все должно работать.
  • Гость: Для домашнего компьютера нужен ключ?
  • Гость: Для домена localhost подойдет любой ключ, если будете использовать на локальном компьютере какой-либо другой домен, то необходимо получить ключ для него.