- Обзор Static API
- Обзор Static API
- Запуск Яндекс.Карт по URL
- Запуск мобильного приложения Яндекс.Карты из браузера
- Запуск мобильного приложения Яндекс.Карты из нативных приложений
- Android
- Запуск веб-версии Яндекс.Карт
- Запуск Яндекс.Карт по URL
- Запуск мобильного приложения Яндекс.Карты из браузера
- Запуск мобильного приложения Яндекс.Карты из нативных приложений
- Android
- Запуск веб-версии Яндекс.Карт
- Выбор типа карты и получение кода или ссылки
- Интерактивная карта
- Статическая карта
- Печатная карта
- Выбор типа карты и получение кода или ссылки
- Интерактивная карта
- Статическая карта
- Печатная карта
Обзор Static API
Static API формирует изображение карты в соответствии со значениями параметров, передаваемых сервису в URL следующего формата:
Строка <параметры URL>представляет собой последовательность пар вида <имя параметра>= <значение параметра>, разделенных символом амперсанда ( & ).
Ниже приведен пример запроса изображения карты центра Москвы с двумя пронумерованными метками:
Ниже приводится полный список параметров URL.
Долгота и широта центра карты в градусах, см. Центр карты.
Протяженность области показа карты по долготе и широте (в градусах), см. Область показа.
Уровень масштабирования карты (0-17), см. Уровень масштабирования карты.
Ширина и высота запрашиваемого изображения карты (в пикселах), см. Размер карты. По умолчанию принимает значение 450×450.
Коэффициент увеличения объектов на карте. Может принимать дробное значение от 1.0 до 4.0. Подробнее см. в разделе Увеличение объектов на карте.
Содержит описание одной или нескольких меток, которые требуется отобразить на карте.
Описание каждой метки содержит ее координаты (долготу и широту), а также сведения о ее внешнем виде (включая стиль, цвет, размер и текст метки). Описания меток перечисляются через тильду (
Содержит набор описаний геометрических фигур (ломаных и многоугольников), которые требуется отобразить на карте.
API позволяет отображать карты, локализованные на различных языках с учетом специфики отдельных стран. Например, можно показать карту с надписями на английском языке и обозначить на ней расстояния в милях (инструмент Линейка).
Обзор Static API
Static API формирует изображение карты в соответствии со значениями параметров, передаваемых сервису в URL следующего формата:
Строка <параметры URL>представляет собой последовательность пар вида <имя параметра>= <значение параметра>, разделенных символом амперсанда ( & ).
Ниже приведен пример запроса изображения карты центра Москвы с двумя пронумерованными метками:
Ниже приводится полный список параметров URL.
Долгота и широта центра карты в градусах, см. Центр карты.
Протяженность области показа карты по долготе и широте (в градусах), см. Область показа.
Уровень масштабирования карты (0-17), см. Уровень масштабирования карты.
Ширина и высота запрашиваемого изображения карты (в пикселах), см. Размер карты. По умолчанию принимает значение 450×450.
Коэффициент увеличения объектов на карте. Может принимать дробное значение от 1.0 до 4.0. Подробнее см. в разделе Увеличение объектов на карте.
Содержит описание одной или нескольких меток, которые требуется отобразить на карте.
Описание каждой метки содержит ее координаты (долготу и широту), а также сведения о ее внешнем виде (включая стиль, цвет, размер и текст метки). Описания меток перечисляются через тильду (
Содержит набор описаний геометрических фигур (ломаных и многоугольников), которые требуется отобразить на карте.
API позволяет отображать карты, локализованные на различных языках с учетом специфики отдельных стран. Например, можно показать карту с надписями на английском языке и обозначить на ней расстояния в милях (инструмент Линейка).
Запуск Яндекс.Карт по URL
Мобильное приложение Яндекс.Карты можно запускать из других приложений и со страниц сайтов. Можно также запускать веб версию Яндекс.Карт, которая не зависит от платформы.
В этом документе описаны способы запуска приложения Яндекс.Карты и веб версии Яндекс.Карт.
Запуск мобильного приложения Яндекс.Карты из браузера
Чтобы дать пользователю возможность запустить приложение Яндекс.Карты со страницы, отображаемой в браузере, необходимо сформировать ссылку, соответствующую приложению. Вместо названия сетевого протокола (обычно http или https) в ссылке указывается URL-схема, отвечающая за запуск приложения.
Список параметров, которые можно указать в URL, приведен в разделах Запуск iOS‑приложения Яндекс.Карты и Запуск Android‑приложения Яндекс.Карты.
Ссылку можно формировать динамически, в зависимости от платформы. Информацию о платформе можно извлечь из:
HTTP‑заголовков, если ссылка формируется на стороне сервера.
Запуск мобильного приложения Яндекс.Карты из нативных приложений
Android
После этого достаточно вызвать метод startActivity класса Context и соответствующее действию Activity запустится. Например, чтобы открыть в Яндекс.Картах карту с заданными координатами центра и масштабом, нужно добавить в приложение следующий код.
Для запуска приложения используется стандартное действие ACTION_VIEW. Координаты центра карты и масштаб указываются в URI.
Список возможных параметров приведен в разделе Запуск Android‑приложения Яндекс.Карты.
Здесь yandexmaps — это название URL‑схемы приложения Яндекс.Карты. Список возможных параметров приведен в разделе Запуск iOS‑приложения Яндекс.Карты.
Запуск веб-версии Яндекс.Карт
Для запуска веб-версии Яндекс.Карт нужно передать в ссылка параметры запроса. Ссылка будет выглядеть следующим образом:
Список доступных параметров доступен в разделе Web.
При открытии ссылки на мобильных устройствах, система может предложить открыть ссылку в установленном приложении. На компьютерах, ссылка открывается в браузере.
Запуск Яндекс.Карт по URL
Мобильное приложение Яндекс.Карты можно запускать из других приложений и со страниц сайтов. Можно также запускать веб версию Яндекс.Карт, которая не зависит от платформы.
В этом документе описаны способы запуска приложения Яндекс.Карты и веб версии Яндекс.Карт.
Запуск мобильного приложения Яндекс.Карты из браузера
Чтобы дать пользователю возможность запустить приложение Яндекс.Карты со страницы, отображаемой в браузере, необходимо сформировать ссылку, соответствующую приложению. Вместо названия сетевого протокола (обычно http или https) в ссылке указывается URL-схема, отвечающая за запуск приложения.
Список параметров, которые можно указать в URL, приведен в разделах Запуск iOS‑приложения Яндекс.Карты и Запуск Android‑приложения Яндекс.Карты.
Ссылку можно формировать динамически, в зависимости от платформы. Информацию о платформе можно извлечь из:
HTTP‑заголовков, если ссылка формируется на стороне сервера.
Запуск мобильного приложения Яндекс.Карты из нативных приложений
Android
После этого достаточно вызвать метод startActivity класса Context и соответствующее действию Activity запустится. Например, чтобы открыть в Яндекс.Картах карту с заданными координатами центра и масштабом, нужно добавить в приложение следующий код.
Для запуска приложения используется стандартное действие ACTION_VIEW. Координаты центра карты и масштаб указываются в URI.
Список возможных параметров приведен в разделе Запуск Android‑приложения Яндекс.Карты.
Здесь yandexmaps — это название URL‑схемы приложения Яндекс.Карты. Список возможных параметров приведен в разделе Запуск iOS‑приложения Яндекс.Карты.
Запуск веб-версии Яндекс.Карт
Для запуска веб-версии Яндекс.Карт нужно передать в ссылка параметры запроса. Ссылка будет выглядеть следующим образом:
Список доступных параметров доступен в разделе Web.
При открытии ссылки на мобильных устройствах, система может предложить открыть ссылку в установленном приложении. На компьютерах, ссылка открывается в браузере.
Выбор типа карты и получение кода или ссылки
После того, как ваша карта создана, вы можете получить код для вставки своей карты на сайт, в блог или мобильное приложение, а также ссылку, по которой вашу карту можно будет увидеть в интернете.
Кроме того, вы можете экспортировать свою карту в файл. См. раздел Экспорт объектов карты.
При подготовке карты следует помнить о Внимание. \\n
Существуют определенные ограничения на создание объектов:
На карту может быть добавлено не более 10 000 объектов (включая и метки, и линии, и многоугольники).
Одна линия или многоугольник могут включать не более 1 000 вершин.
Если число вершин объекта превышает эту величину, объект можно автоматически упростить: удалить некоторые вершины таким образом, чтобы максимально сохранить общий вид объекта.
Для этого выберите нужный тип карты (нажмите кнопку на панели Тип карты ):
Подробнее об этом типе и существующих ограничениях см. раздел Печатная карта.
Интерактивная карта
Чтобы получить код для вставки на сайт, в блог или мобильное приложение своей карты таким образом, что с ней можно будет взаимодействовать (двигать, менять масштаб, строить маршруты, просматривать описания и т. п.), выберите тип карты Интерактивная :
В открывшейся форме вы можете скопировать код, который позволит отобразить вашу карту на сайте или в блоге (доступны два варианта HTML-кода ─ JavaScript или iframe ):
Использование кода iframe имеет ограничения:
карта может отображаться только на крупных масштабах,
не все теги HTML будут работать (см. \\n \\n Некоторые теги HTML не работают на карте при вставке через iframe: \\n \\n
не показываются произвольные изображения, тег img ( <img src=\\»my-picture.png\\» />);
не запускаются скрипты, тег script ( <script src=\\»\\»></script>);
не обрабатываются \\nинлайн-стили ( style=\\». \\») и инлайн-скрипты ( onclick=\\». \\») и т. п.
При использовании кода JavaScript по умолчанию на карте Конструктора нет поиска / маршрутов / панорам.
Чтобы они появились, нужно получить API-ключ в Кабинете разработчика для продукта «JavaScript API и HTTP Геокодер» и добавить его в код.
Пример кода с использованием API-ключа:
Ваша карта откроется на Яндекс.Картах вместе с информационной панелью (см. выше).
В открывшейся форме вы можете скопировать ссылку на карту (или код, который позволит отобразить вашу карту).
Статическая карта
Чтобы получить код для вставки своей карты в виде статического изображения (такие карты можно размещать на сайтах без поддержки JavaScript), выберите тип карты Статическая :
В открывшейся форме вы можете скопировать код, который позволит отобразить вашу карту. Подробнее см. в разделе API Конструктора Карт.
Печатная карта
Чтобы сохранить на Яндекс.Диске файл, содержащий изображение карты в высоком разрешении, которое можно распечатать, или чтобы непосредственно отправить свою карту на печать в текущем разрешении, выберите тип карты Печатная :
Для печатных карт вы можете выбрать единицу измерения: пиксели ( px ), дюймы ( in ) или сантиметры ( cm ).
Печатные карты высокого разрешения можно создать:
Только для карт вида Схема; для спутниковых снимков и гибридов карты для печати создать нельзя.
Только для крупных масштабов карты; для обзорных (мелких) масштабов печатные карты создать нельзя.
Только в последних версиях настольных браузеров Firefox, Chrome, Яндекс.Браузер, Edge, Safari и Opera.
Файл будет сохранен в автоматически созданной папке Конструктор Яндекс.Карт вашего Яндекс.Диска под тем именем, которое вы дали карте.
Выбор типа карты и получение кода или ссылки
После того, как ваша карта создана, вы можете получить код для вставки своей карты на сайт, в блог или мобильное приложение, а также ссылку, по которой вашу карту можно будет увидеть в интернете.
Кроме того, вы можете экспортировать свою карту в файл. См. раздел Экспорт объектов карты.
При подготовке карты следует помнить о Внимание. \n
Существуют определенные ограничения на создание объектов:
На карту может быть добавлено не более 10 000 объектов (включая и метки, и линии, и многоугольники).
Одна линия или многоугольник могут включать не более 1 000 вершин.
Если число вершин объекта превышает эту величину, объект можно автоматически упростить: удалить некоторые вершины таким образом, чтобы максимально сохранить общий вид объекта.
Для этого выберите нужный тип карты (нажмите кнопку на панели Тип карты ):
Подробнее об этом типе и существующих ограничениях см. раздел Печатная карта.
Интерактивная карта
Чтобы получить код для вставки на сайт, в блог или мобильное приложение своей карты таким образом, что с ней можно будет взаимодействовать (двигать, менять масштаб, строить маршруты, просматривать описания и т. п.), выберите тип карты Интерактивная :
В открывшейся форме вы можете скопировать код, который позволит отобразить вашу карту на сайте или в блоге (доступны два варианта HTML-кода ─ JavaScript или iframe ):
Использование кода iframe имеет ограничения:
карта может отображаться только на крупных масштабах,
не все теги HTML будут работать (см. \n \n Некоторые теги HTML не работают на карте при вставке через iframe: \n \n
не показываются произвольные изображения, тег img ( );
не запускаются скрипты, тег script ( );
не обрабатываются \nинлайн-стили ( style=\». \») и инлайн-скрипты ( onclick=\». \») и т. п.
При использовании кода JavaScript по умолчанию на карте Конструктора нет поиска / маршрутов / панорам.
Чтобы они появились, нужно получить API-ключ в Кабинете разработчика для продукта «JavaScript API и HTTP Геокодер» и добавить его в код.
Пример кода с использованием API-ключа:
Ваша карта откроется на Яндекс.Картах вместе с информационной панелью (см. выше).
Нажмите на этой панели кнопку Поделиться 
.
В открывшейся форме вы можете скопировать ссылку на карту (или код, который позволит отобразить вашу карту).
Статическая карта
Чтобы получить код для вставки своей карты в виде статического изображения (такие карты можно размещать на сайтах без поддержки JavaScript), выберите тип карты Статическая :
В открывшейся форме вы можете скопировать код, который позволит отобразить вашу карту. Подробнее см. в разделе API Конструктора Карт.
Печатная карта
Чтобы сохранить на Яндекс.Диске файл, содержащий изображение карты в высоком разрешении, которое можно распечатать, или чтобы непосредственно отправить свою карту на печать в текущем разрешении, выберите тип карты Печатная :
Для печатных карт вы можете выбрать единицу измерения: пиксели ( px ), дюймы ( in ) или сантиметры ( cm ).
Печатные карты высокого разрешения можно создать:
Только для карт вида Схема; для спутниковых снимков и гибридов карты для печати создать нельзя.
Только для крупных масштабов карты; для обзорных (мелких) масштабов печатные карты создать нельзя.
Только в последних версиях настольных браузеров Firefox, Chrome, Яндекс.Браузер, Edge, Safari и Opera.
Файл будет сохранен в автоматически созданной папке Конструктор Яндекс.Карт вашего Яндекс.Диска под тем именем, которое вы дали карте.
detector