ВебмастерМетрикаВиджетыРекламная сетьДиректПоиск для сайтаAPI
ещё
Найти
Например, ymaps:GeoObjectCollection

API Карт:

Войти

API в действии

Задать вопрос в клубе разработчиков

Кстати

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

Вопросы и ответы

Вначале

Использование API

О Пользовательском соглашении

Как спросить

Вначале

  • Как мне начать использовать API Яндекс.Карт на своём сайте?

    Сделать это достаточно просто:

    1. Если вы уже зарегистрированы на Яндексе, авторизуйтесь (введите свой логин и пароль). Если логина и пароля у вас нет, вам необходимо зарегистрироваться.

    2. Заполните форму, обязательно указав адрес вашего сайта, и получите уникальный API-ключ.

    3. Ознакомьтесь с документацией и примерами.

    4. Разместите JavaScript-код на страницах своего сайта. Этого достаточно чтобы ваши пользователи получили географический сервис.

  • Что такое API-ключ и зачем он нужен?

    Это уникальный ключ, который позволит использовать API Яндекс.Карт только на вашем сайте. Именно поэтому для получения ключа в форме регистрации требуется указать URL вашего сайта. Использование одного ключа на нескольких сайтах невозможно.

  • Могу ли я использовать на своём сайте изображения, взятые с Яндекс.Карт, без использования API?

    Нет, на данный момент это невозможно.

  • Какие браузеры поддерживает API Яндекс.Карт?

    Сейчас карты можно смотреть в браузерах Microsoft Internet Explorer 6.x, Microsoft Internet Explorer 7.x, Mozilla Firefox 2.x, Mozilla Firefox 3.x, Opera 9.x, Apple Safari 3.1 и выше. Если вместо карты вы видите серый прямоугольник, то, видимо, у вас другой браузер. Со временем мы надеемся расширить список браузеров для работы с нашим сервисом.

  • Где можно почитать документацию по API Яндекс.Карт?

    Подробная документация по API Яндекс.Карт расположена в разделе «Документация». Кроме того, вы можете найти ответы на интересующие вас вопросы в Клубе разработчиков API Яндекс.Карт.

  • Что делать, если нет подробной карты моего города?

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

Использование API

  • Как лучше указать адрес сайта для получения ключа?

    В качестве адреса сайта лучше всего указывать только домен (например, mydomain.com). Ключ, зарегистрированный на отдельный домен, будет действителен для всех url внутри этого домена и для специальных поддоменов (например для "www"). Ключ, зарегистрированный на домен http://mydomain.com/, будет действителен для:

    • http://mydomain.com/

    • http://www.mydomain.com/

    • http://www.mydomain.com/page/

    • http://host1.mydomain.com/

    • http://host2.mydomain.com/page/

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

  • Как подключить API для сайтов-зеркал?

    Если у сайта есть доменные зеркала, то для того, чтобы загрузка API работала одновременно и на страницах основного сайта, и на страницах зеркал в параметр key следует добавить API-ключи зеркал сайта через тильду (~):

    <script src="http://api-maps.yandex.ru/1.1/index.xml?key=API-ключ1~API-ключ2" type="text/javascript"></script>

    Через тильду можно подключить не более 5 сайтов. Если указано большее количество, то будут обработаны только первые 5 ключей.

  • Какой ключ использовать для разработки на локальной машине?

    Для доменов localhost и 127.0.0.1 не проверяется соответствие ключа домена, поэтому для них можно использовать любой ключ (например, который вы планируете использовать на своём сайте).

    Регистрировать ключи для доменов первого уровня, например http://dev/, нельзя. Однако, при разработке на локальной машине можно создать домен второго уровня, например http://dev.maps/ и получить ключ для него.

  • На скольких сайтах можно использовать один и тот же API-ключ?

    Один API-ключ может быть использован только на одном сайте. Например, если при регистрации вы указали в качестве URL mysite.ru, то полученный ключ будет работать во всех внутренних разделах этого сайта, например, в таком: mysite.ru/map/.

    Однако вы можете использовать несколько API-ключей на одном сайте. Для этого надо запросить по ключу для каждого из требуемых разделов. Например, один ключ для раздела mysite.ru/map/ и другой ключ для раздела mysite.ru/about/.

  • Я потерял API-ключ. Что делать?

    Для восстановления ключа вам необходимо снова обратиться к форме регистрации API-ключей. Оттуда вы сможете перейти на страницу со списком ваших ключей.

  • Как включить режим «масштабирование карты колесом мыши»?

    По умолчанию масштабирование карты происходит по двойному щелчку мыши. Вы можете включить и отключить изменение масштаба карты колесом мыши с помощью методов enableScrollZoom() и disableScrollZoom() соответственно.

О Пользовательском соглашении

  • Насколько сложно выполнять условия Пользовательского соглашения?

    Условия Пользовательского соглашения выполнять очень легко, если ваш сайт не взимает плату с пользователей за сервис, связанный с картами, не нарушает действующее законодательство Российской Федерации и соответствует другим требованиям Пользовательского соглашения.

  • На моём сайте существует обязательная регистрация пользователей. Я могу использовать API Яндекс.Карт?

    Да, Пользовательское соглашение допускает использование API Яндекс.Карт на сайтах, доступ к которым ограничен регистрацией. Важно, чтобы регистрация была бесплатной. Также вы должны убедиться, что ваш сайт не нарушает другие условия Соглашения.

  • Могу ли я использовать API Яндекс.Карт на коммерческом сайте?

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

    В частности, ваш сайт не должен взимать плату за просмотр информации на картах, при этом взимать плату за размещение пользователями или рекламодателями информации на карте вы можете. Подробнее об условиях Пользовательского соглашения читайте в соответствующем разделе.

  • Могу ли я использовать карты или спутниковые снимки как-либо иначе, кроме как через API?

    Нет, вы не можете их использовать никак, кроме как посредством API в соответствии с условиями Пользовательского соглашения.

  • Могу ли я использовать API Яндекс.Карт в не веб-приложениях?

    Нет, это запрещено Пользовательским соглашением.

  • Могу ли я кешировать результаты геокодирования?

    Да, это возможно в случае если хранение временное и служит для улучшения функциональности и работоспособности вашего сайта.

Как спросить

  • Как можно получить помощь, сообщить о найденной ошибке или предложить интересную идею?

    Отправьте нам сообщение любым удобным для вас способом: по адресу support@api-maps.yandex.ru, заполнив форму обратной связи или написав в Клуб API Яндекс.Карт.

    Мы постараемся оперативно ответить на вопросы, исправить обнаруженные ошибки и реализовать интересные идеи.