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