---
metadata:
- name: generator
content: Diplodoc Platform v5.39.1
alternate:
- https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/quick-start/index.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/llms.txt
# Начало работы с API
JavaScript API Яндекс.Карт — это набор JavaScript-компонентов, позволяющий размещать на страницах сайта интерактивные карты.
Для того чтобы вставить карту на страницу и разместить на ней объект (например, метку), выполните описанные ниже действия.
## Шаг 1. Получите API-ключ {#get-api-key}
Зайдите на страницу [Кабинета Разработчика](https://developer.tech.yandex.ru) и нажмите кнопку **Получить ключ**. Во всплывающем окне выберите сервис «JavaScript API».
После заполнения формы появится надпись «Сервис успешно подключен». Созданный ключ будет доступен в разделе «Ключи». Его необходимо использовать в дальнейшем при подключении API.
{% note info %}
Ключ будет активирован в течение 15 минут после получения.
{% endnote %}
## Шаг 2. Подключите API {#load_api}
Прежде чем использовать функции API, необходимо загрузить в браузер JavaScript-файлы, в которых эти функции определены. Для этого добавьте в заголовок `head` HTML-страницы строку следующего вида:
```xml
...
...
```
По адресу `api-maps.yandex.ru/2.0-stable/` находится загрузчик, который при обращении к нему подключает нужные компоненты API.
[Подробнее о подключении API](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/dg/concepts/load.md).
## Шаг 3. Создайте контейнер для карты {#create_map_container}
Создайте видимый контейнер ненулевого размера, в котором будет размещена карта. В качестве контейнера может использоваться любой HTML-элемент блочного типа (например, элемент `div` с заданной шириной и высотой). Карта заполнит этот элемент полностью.
```xml
```
Уникальный идентификатор (`id`) контейнера будет использоваться в следующем шаге для получения указателя на контейнер карты.
## Шаг 4. Создайте карту {#create_map}
Создайте экземпляр класса карты, в конструкторе которого укажите id контейнера, ее центр и коэффициент масштабирования.
```xml
```
{% note info %}
По умолчанию координаты принято задавать в последовательности «широта, долгота». Изменить порядок задания координат можно с помощью параметра [coordorder](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/dg/concepts/load.md#coordorder) при подключении API.
Для того чтобы не определять координаты центра карты вручную, воспользуйтесь инструментом [Определение координат](http://dimik.github.io/ymaps/examples/location-tool/).
{% endnote %}
Создавать карту следует после того, как веб-страница загрузится целиком. Это даст уверенность в том, что контейнер для карты создан и к нему можно обращаться по `id`. Чтобы инициализировать карту после загрузки страницы, можно воспользоваться функцией ready().
Функция ready вызовется тогда, когда API будет загружен и DOM сформирован:
```xml
```
[Подробнее о создании карты](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/dg/concepts/map.md).
## Шаг 5. Добавьте метку на карту {#add-object}
В API метки реализуются с помощью класса `Placemark`. Перед тем как добавить метку на карту, создайте экземпляр этого класса. При создании метки вы можете задать текст её иконки, а также текст балуна, который откроется при нажатии кнопкой мыши на этой метке.
```
```
После того как метка была создана, её можно добавить на карту. Добавление объектов на карту осуществляется через их добавление в глобальную коллекцию объектов карты `myMap.geoObjects`:
```
```
[Подробнее об объектах карты](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/dg/concepts/geoobjects.md).
## Результат {#result_map}
Полный текст примера:
```
Быстрый старт. Размещение интерактивной карты на странице
```
С примерами можно ознакомиться в [песочнице](https://tech.yandex.ru/maps/jsbox/2.0/).
## Не получилось? {#problems}
Если при работе с API возникли проблемы, выполните следующие действия:
1. Поищите описание проблемы в [Клубе Разработчиков](http://clubs.ya.ru/mapsapi/) API Яндекс.Карт. Если готового ответа не нашлось, задайте вопрос экспертам клуба.
2. Отправьте нам письмо с описанием проблемы с помощью [формы обратной связи](http://feedback.yandex.ru/?from=api-maps).