# Документация

Подключите карту, адресный поиск, маршрут и матрицу расстояний к своему сайту или приложению.



## С чего начать

Для карты достаточно подключить JavaScript и CSS SDK **1.0.0-rc.9**. Регистрация и ключ не нужны. Для поиска адресов, расчёта маршрута и матрицы создайте проект и API-ключ.

API можно попробовать в пределах бесплатной квоты после регистрации и подтверждения email. Пополнять баланс и привязывать банковскую карту для этого не нужно. [Получить ключ и выполнить первый запрос](https://mmapps.ru/docs/getting-started).

| Задача | Раздел |
| --- | --- |
| Выполнить первый запрос API | [Быстрый старт](https://mmapps.ru/docs/getting-started) |
| Добавить карту на страницу | [Подключение карты](https://mmapps.ru/docs/maps) |
| Работать с объектами, событиями и интерфейсом карты | [Полный справочник SDK RC9](https://mmapps.ru/docs/sdk) |
| Найти адрес или координаты | [Поиск адресов](https://mmapps.ru/docs/addresses) |
| Рассчитать автомобильный путь | [Маршрут](https://mmapps.ru/docs/routes) |
| Сравнить расстояния и время между точками | [Матрица расстояний](https://mmapps.ru/docs/matrix) |
| Выдать права и ограничить доступ | [Ключи API](https://mmapps.ru/docs/keys) |
| Узнать цену и контролировать расходы | [Расходы и лимиты](https://mmapps.ru/docs/billing) |

## Справочники и файлы

- [OpenAPI](https://mmapps.ru/gateway.openapi.yaml) — HTTP-методы, поля запросов и ответов, ошибки и ограничения.
- [Типы SDK](https://cdn.mmapps.ru/sdk/1.0.0-rc.9/index.d.ts) — точные сигнатуры JavaScript API в формате TypeScript.
- [Список разделов в Markdown](https://mmapps.ru/llms.txt).
- [Вся документация одним файлом](https://mmapps.ru/llms-full.txt).

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

## Условия использования

Карта и SDK бесплатны. Запросы сервисного API используют бесплатную квоту, а после её исчерпания — баланс аккаунта. Расчёт матрицы учитывается по числу пар точек. Доступность операций и права ключа проверяйте в кабинете.

Ммаппс можно использовать в CRM и других приложениях за авторизацией. Результаты API разрешено сохранять в своей базе и использовать повторно с соблюдением лицензий исходных данных и требований к персональным данным. [Подробнее о хранении и оплате](https://mmapps.ru/docs/billing).

[Пользовательское соглашение](https://mmapps.ru/documents/terms), [обработка персональных данных](https://mmapps.ru/documents/terms#privacy) и [лицензии SDK и карты](https://mmapps.ru/documents/sdk-license).

## Чтение без интернета

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