---
metadata:
- name: generator
content: Diplodoc Platform v5.39.1
alternate:
- en/
- ru/
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v2-1/doc/ru/llms.txt
# Быстрый старт
Ниже приведены инструкции, как показать на странице простую карту.
{% note alert %}
API-ключ — обязательное условие использования бесплатной версии API Яндекс Карт.
{% endnote %}
1. [Получите API-ключ](#get-api-key)
1. [Подключите API](#api-load_api)
1. [Создайте контейнер для карты](#create_map_container)
1. [Создайте карту](#create_map)
## Шаг 1. Получите API-ключ {#get-api-key}
Зайдите на страницу [Кабинета Разработчика](https://developer.tech.yandex.ru) и нажмите кнопку **Получить ключ**. Во всплывающем окне выберите сервис «JavaScript API».
После заполнения формы появится надпись «Сервис успешно подключен». Созданный ключ будет доступен в разделе «Ключи». Его необходимо использовать в дальнейшем при подключении API.
{% note info %}
Ключ будет активирован в течение 15 минут после получения.
{% endnote %}
## Шаг 2. Подключите API {#load_api}
Добавьте в заголовок `head` HTML-страницы строку следующего вида:
```xml
```
[Подробнее о подключении API](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/load.md)
## Шаг 3. Создайте контейнер для карты {#create_map_container}
Создайте видимый контейнер **ненулевого** размера, в котором будет размещена карта. В качестве контейнера может использоваться любой HTML-элемент блочного типа (например, элемент `div`). Карта заполнит этот элемент полностью.
```xml
```
Уникальный идентификатор контейнера (в примере это `id="map"`) будет использоваться в следующем шаге для получения указателя на контейнер карты.
## Шаг 4. Создайте карту {#create_map}
В JavaScript-коде создайте экземпляр карты. Конструктору нужно передать:
- идентификатор HTML-контейнера;
- центр карты;
- коэффициент масштабирования.
Пример:
```xml
```
{% note alert %}
Создавать карту следует после того, как веб-страница загрузится целиком и будет создан контейнер с id. Это нужно, чтобы к нему можно обращаться по `id`. Чтобы инициализировать карту после загрузки страницы, можно воспользоваться функцией [ready()](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ready.md). Она вызовется тогда, когда API будет загружен и DOM сформирован.
{% endnote %}
[Подробнее о создании карты](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/map.md)
## Результат {#result_map}
Полный текст примера:
```xml
Быстрый старт. Размещение интерактивной карты на странице
```
С примерами можно ознакомиться в [песочнице](https://tech.yandex.ru/maps/jsbox/2.1/).