---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://yandex.ru/dev/developer-help/doc/en/quickstart.md
  - https://yandex.ru/dev/developer-help/doc/ru/quickstart.md
  - https://yandex.ru/dev/developer-help/doc/tr/quickstart.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/developer-help/doc/ru/llms.txt

### Быстрый старт

## **Шаг 1. Авторизуйтесь** {#auth}

{% note info "**Примечание**" %}

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

{% endnote %}

Откройте [кабинет](https://developer.tech.yandex.ru/?modern=true) API Яндекс Карты и войдите с Яндекс ID. Если у вас еще нет логина, [зарегистрируйтесь](https://passport.yandex.ru/registration?mode=register).

{% note info "**Примечание**" %}

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

{% endnote %}

## **Шаг 2. Выберите продукт API** {#create}

Если у вас нет подключенных API:

1. {% cut "На главной странице наведите указатель курсора  на карточку продукта и нажмите всплывающую кнопку **Подключить**." %}

    ![](_assets/api-connect-first-time.png)

    {% endcut %}

Если у вас уже подключены API:

1. На главной странице нажмите кнопку **Подключить API**.
2. {% cut "В открывшемся окне наведите указатель курсора на карточку продукта и нажмите на нее." %}

    ![](_assets/api-connect.png)

    {% endcut %}
    1. {% cut "Если требуется подключить продукт не относящийся к API Яндекс Карты, наведите указатель курсора на кнопку **Еще** и нажмите ее" %}

        ![](_assets/api-other-connect.png)

        {% endcut %}

    2. Наведите указатель на карточку продукта и нажмите ее.

3. {% cut "Нажмите кнопку **Подключить API**." %}

    ![](_assets/api-connect-btn.png)

    {% endcut %}

## **Шаг 3. Выберите тариф** {#create}

В открывшейся странице **Тарифы**:

1. Нажмите радио-кнопку **Параметры использования** продукта.
    1. Настройте параметры использования платного тарифа\*:
        1. {% cut "Выберите  срок действия платного тарифа - период оплаты: 1 год или 1 месяц." %}

            ![](_assets/tariff-choose-period.png)

            {% endcut %}

        2. {% cut "Выберите дату начала действия тарифа." %}

            ![](_assets/tariff-choose-date.png)

            {% endcut %}

        3. {% cut "Установите ползунок в необходимый лимит запросов в сутки." %}

            ![](_assets/tariff-choose-limit.png)

            {% endcut %}

        4. {% cut "Укажите требуется ли расширенная лицензия для сохранения результатов в течение срока действия платного тарифа." %}

            ![](_assets/tariff-choose-saving.png)

            {% endcut %}

    2. {% cut "Ознакомьтесь с условиями [Оферты](https://yandex.ru/legal/maps_api_offer/ru/) и  проставьте галочку." %}

        ![](_assets/tariff-accept-conditions.png)

        {% endcut %}

    3. {% cut "Нажмите кнопку **Подключить.**" %}

        ![](_assets/tariff-connect.png)

        {% endcut %}

## **Шаг 4. Оплатите стоимость тарифа** {#create}

В открывшейся странице **Тарифы** - **Оплата Тарифа** нужно выбрать плательщика и выставить счет на сумму стоимости тарифа. Если у вас уже есть плательщики, выберите одного из списка. Если вы оплачиваете в первый раз, добавьте нового:

1.  {% cut "Выберите тип плательщика — юридическое или физическое лицо." %}

    ![](_assets/payer-type.png)

    {% endcut %}

2.  Заполните данные плательщика:
    1. Юридическое лицо - ИНН, название организации, полное название организации с формой собственности, номер телефона, адрес электронной почты, юридический адрес, почтовый адрес, индекс.
    2. Физическое лицо - фамилия, имя, отчество, номер телефона, адрес электронной почты.

3.  {% cut "Сумма платежа автоматически выставляется равной стоимости тарифа. " %}

    ![](_assets/payment-sum.png)

    {% endcut %}

4.  {% cut "Нажмите кнопку **Выставить счет**." %}

    ![](_assets/payment-btn.png)

    {% endcut %}
    1. В новой вкладке браузера автоматически откроется [страница](https://balance.yandex.ru/) ЛК Яндекс Баланса, где вы сможете скачать созданный счет для оплаты тарифа банковским переводом, картой и т.д.

    2. {% cut "Проверьте выбранного плательщика." %}

        ![](_assets/balance-payer.png)

        {% endcut %}

    3. {% cut "Выберите способ оплаты." %}

        ![](_assets/balance-payment-type.png)

        {% endcut %}

    4. {% cut "Нажмите кнопку **Выставить счёт** *на сумму*." %}

        ![](_assets/balance-invoice-btn.png)

        {% endcut %}

    5. {% cut "Счёт выставлен — его можно скачать или отправить на почту." %}

        ![](_assets/balance-invoice.png)

        {% endcut %}

5.  {% cut "Вернитесь кабинет API Яндекс Карт на вкладку браузера со страницей **Тарифы** - **Оплата Тарифа** и для продолжения работы нажмите кнопку **Перейти к продукту**." %}

    ![](_assets/go-to-product.png)

    {% endcut %}

6.  {% cut "На странице продукта представлены секции **Тариф**, **Плательщик**, **Ключи** и **Статистика**." %}

    ![](_assets/service-page.png)

    {% endcut %}

{% note info "**Примечание**" %}

Срок поступления денежных средств зависит от банка и от выбранного способа оплаты, как правило, платежи по карте доходят быстрее, далее следует банковский перевод и самым медленным является перевод с использованием QR-кода.

После поступления денежных средств на Лицевой счет плательщика в Яндекс Баланс платный тариф активируется в выбранную дату начала действия тарифа.

{% endnote %}

## **Шаг 5. Настройте API-ключ (для JavaScript API)** {#create}

{% note info "**Примечание**" %}

JavaScript API 3.0 работает только с ключами, у которых заполнено поле "Ограничение по HTTP Referer". [Подробнее об ограничениях](https://yandex.ru/maps-api/docs/js-api/limit.html)

{% endnote %}

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

Чтобы настроить ключ на странице продукта JavaScript API, в секции **Ключи**:

1. {% cut "Найдите ключ, автоматически созданный при подключения продукта JavaScript API. Статус ключа -  **Не настроен**." %}

    ![](_assets/find-key.png)

    {% endcut %}

2. {% cut "Справа в строке с данными о ключе нажмите ![](_assets/dots.png =32x15) и затем **Настроить**." %}

    ![](_assets/key-settings.png)

    {% endcut %}

3. {% cut "Настройте ограничения ключа -  **Ограничение по HTTP referer**." %}

    ![](_assets/key-jsapi-referrer.png)

    {% endcut %}

4. Нажмите кнопку **Сохранить**.

5. {% cut "Удостоверьтесь, что статус ключа сменился на **Активен**." %}

    ![](_assets/key-active.png)

    {% endcut %}

{% note info "**Примечание**" %}

Для блокировки связки ключ-продукт выберите ключ, нажмите ![](\_assets/dots.png =32x15) и **Отвязать продукт**, статус связки ключ-продукт сменится на "Не активен".

{% endnote %}

## **Следующие шаги** {#create}

Также в Кабинете вы можете:

- Добавлять новые ключи, привязывать/отвязывать ключи к продуктам API Яндекс Карты, изменять название ключа

- Просматривать и скачивать статистику по отдельным ключам и продуктам

- Пополнять Лицевой Счет, переключаться между плательщиками

- Переходить по ссылкам в ЛК Яндекс Баланса для изменения данных плательщика и ознакомления с актами и документами

Для части продуктов также есть бесплатный тариф.