Конструктор яндекс карт экспорт

Обновлено: 15.05.2024

Мне довелось допиливать небольшой проект(~500h), в котором на старте было принято решение использовать Yandex.Maps API, потому что зачем для Москвы использовать гугл карты, если есть наши. Сейчас расскажу, как все прошло.

Я не проводил глубоких подкапотных исследований и никаких секретов не открою. Но, если вам, как и мне, надо очень быстро (вчера) начать использовать в вашем проекте карты, надеюсь, помогу сэкономить немного времени.

Если лень читать или сразу нужен вывод, отправляю в последнее “Действие 4: Это конец / TL;DR”

Действие 0: Определения

Начнем с определений: что, зачем, почему.

Задача: отобразить карту Москвы, пинами указать конкретные места, уметь построить маршрут от текущего положения до конкретной точки (или до нескольких).
Технология: Yandex.Maps API. Ссылки на документацию[1] ниже.
Итого: прочитайте документацию, реализуйте фичи.

Все выглядит просто, что может пойти не так.

Действие 1: Поиск

В “. /maps” [4] нас ждут только бесконечный поиск, разочарование и страдания. Которые к нужной документации меня так и не привели.

Возвращаемся на шаг назад, листаем вниз и находим MapKit [5] — нам сюда. Навигация тут довольно грустная, поэтому вот важные ссылки — android samples [6] и Documentation [7] (возможно, иногда получится найти тут что-то полезное).

Действие 2: Поехали

Находим Getting started и приступаем. В начале все просто.

На “Step 3. Set up the library” возникают вопросы. Вью и фабрику нужно обязательно стартовать и останавливать отдельно, иначе, как нам сообщают, ничего не будет работать. Почему? А что будет, если что-то стартану, а что-то нет, или стартану что-то позже? А если несколько вьюх, то для каждого надо фабрику, или это синглтон?

Возможно, это всего лишь QuickStart и дальше мы найдем подробное описание! (нет)

Давайте смотреть, что есть по документации. А все, ничего больше нет. Есть только сгенерированная документация с комментариями типа:

Ладно, на гитхабе есть еще проект с примерами использования [8]. Внутри каждого класса активити есть комментарии о том, что он делает и зачем нужен (после документации это просто подарок судьбы). Есть несколько сценариев: создание кастомного слоя карты, построение маршрута для автомобиля, работа с объектами на карте и некоторые другие.

Выглядит ли апи мощным? Да.
Понятно ли как им пользоваться в случаях, чуть более сложных, чем примеры? Нет.(
Как это понять? ¯_(ツ)_/¯ Нырять с головой в код, по итогу исследований продавать книжку о том, что нашел.

Действие 3: Разрабатываем

Задача 1: отобразить карту
Сложностей не встретил, все есть в гайде.

Задача 2: отобразить пины
Нам нужен “MapObjectsActivity.java", то, что мы ищем, называется Placemarks. Смотрим в код, чтобы понять, что с ними делать.

Задача 3: построить маршрут
Наш друг тут — “MasstransitRoutingActivity.java”. Маршрут можно попросить разный: только на машине, только пешком, и так и сяк; наверняка можно еще учесть метро и другие разные штуки, но я недонырнул.

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

Действие 4: Это конец / TL;DR

Общие итоги:
Яндекс карты классные. Как ими пользоваться — непонятно.

Хорошая документация, чтобы “потрогать” сервис. Ужасная документация, чтобы что-то с ним сделать. Структура ссылок — “Хрен найдешь”, качество находки — “Вот колесо, оно катится. А далее вы сами легко сможете изобрести машину, ракету, подводную лодку”.

Основные моменты:
Как отобразить карту в проекте? Ссылка [7], тут всё просто.
Как добавить пин на карту? Ключевые слова Placemark, MapObjects. Искать в samples.
Как построить маршрут? Ключевое слово MasstransitRouting. Искать в samples.
Как сделать что-то еще? Искать в samples. Если там нет, то у вас проблемы.

Вы можете сохранить объекты вашей карты на Яндекс Диск в виде файла одного из нескольких форматов.

Эти файлы можно использовать для импорта нужных точек в программы-навигаторы, поддерживающие импорт GPS-координат, для использования совместно с API Яндекс Карт, для просмотра и сохранения данных в других программах (например, в Google Earth) и т. п.

При экспорте сохраняется информация только об объектах вашей карты.

Перейдите по ссылке Экспорт панели:

В открывшейся форме Экспорт объектов карты выберите тип файла:

Объекты вашей карты будут сохранены на Яндекс Диске в папке Конструктор карт / Экспорт в виде файла выбранного формата с названием [Название карты + Дата + Время].

KML (от англ. Keyhole Markup Language, язык разметки Keyhole): формат на основе XML. Подходит для импорта объектов на карту, созданную в API Яндекс Карт или Google Earth.

В файл сохранятся\nметки (координаты, описание, подпись, цвет),\nлинии и многоугольники.

Пример использования файлов формата KML в API Яндекс Карт можно посмотреть в разделе Отображение GPX и KML документации API Яндекс Карт.

При открытии файла программой, предназначенной для просмотра файлов данного типа (например, Google Earth), вы увидите объекты своей карты:

XLSX (электронная таблица Microsoft Excel).

В файл сохранятся\nметки (координаты, описание, подпись). По столбцам: широта, долгота, описание, подпись:

CSV (от англ. Comma-Separated Values — значения, разделeнные запятыми): текстовый формат, предназначенный для представления табличных данных. Файл такого формата можно открывать в текстовых и табличных редакторах.

Текст разбивается на столбцы с помощью специальных символов — разделителей. Для выбора разделителя нажмите нужную кнопку Разделитель :\nЗапятая, Точка с запятой или Табуляция.

В файл сохранятся\nметки (координаты, описание, подпись, номер).

Координаты сохраняются в порядке [широта, долгота].

При открытии файла программой, предназначенной для просмотра файлов данного типа, вы увидите данные объектов своей карты:

GPX (от англ. GPS eXchange Format): текстовый формат хранения и обмена данными GPS, основанный на XML. Можно использовать в GPS-приложениях и API Яндекс Карт (пример) . Например, чтобы задать маршрут.

В файл сохранятся\nметки (только координаты)\nи линии (только координаты).

GeoJSON

GeoJSON : формат геоданных на основе JSON.

Поддерживается API Яндекс Карт, OpenLayers, Leaflet, Bing Maps, Yahoo! Maps и другими картографическими сервисами (пример) .

В файл сохранятся\nметки (координаты, описание, подпись, номер, цвет),\nлинии (координаты, описание, цвет) и многоугольники (координаты, описание, цвет).

Координаты сохраняются в порядке [долгота, широта].

Вы можете сохранить объекты вашей карты на Яндекс Диск в виде файла одного из нескольких форматов.

Эти файлы можно использовать для импорта нужных точек в программы-навигаторы, поддерживающие импорт GPS-координат, для использования совместно с API Яндекс Карт, для просмотра и сохранения данных в других программах (например, в Google Earth) и т. п.

При экспорте сохраняется информация только об объектах вашей карты.

Перейдите по ссылке Экспорт панели:

В открывшейся форме Экспорт объектов карты выберите тип файла:


Объекты вашей карты будут сохранены на Яндекс Диске в папке Конструктор карт / Экспорт в виде файла выбранного формата с названием [Название карты + Дата + Время].

KML (от англ. Keyhole Markup Language, язык разметки Keyhole): формат на основе XML. Подходит для импорта объектов на карту, созданную в API Яндекс Карт или Google Earth.

В файл сохранятся метки (координаты, описание, подпись, цвет), линии и многоугольники.

Пример использования файлов формата KML в API Яндекс Карт можно посмотреть в разделе Отображение GPX и KML документации API Яндекс Карт.

При открытии файла программой, предназначенной для просмотра файлов данного типа (например, Google Earth), вы увидите объекты своей карты:


XLSX (электронная таблица Microsoft Excel).

В файл сохранятся метки (координаты, описание, подпись). По столбцам: широта, долгота, описание, подпись:


CSV (от англ. Comma-Separated Values — значения, разделeнные запятыми): текстовый формат, предназначенный для представления табличных данных. Файл такого формата можно открывать в текстовых и табличных редакторах.

Текст разбивается на столбцы с помощью специальных символов — разделителей. Для выбора разделителя нажмите нужную кнопку Разделитель : Запятая, Точка с запятой или Табуляция.

В файл сохранятся метки (координаты, описание, подпись, номер).

Координаты сохраняются в порядке [широта, долгота].

При открытии файла программой, предназначенной для просмотра файлов данного типа, вы увидите данные объектов своей карты:


GPX (от англ. GPS eXchange Format): текстовый формат хранения и обмена данными GPS, основанный на XML. Можно использовать в GPS-приложениях и API Яндекс Карт (пример) . Например, чтобы задать маршрут.

В файл сохранятся метки (только координаты) и линии (только координаты).

GeoJSON

GeoJSON : формат геоданных на основе JSON.

Поддерживается API Яндекс Карт, OpenLayers, Leaflet, Bing Maps, Yahoo! Maps и другими картографическими сервисами (пример) .

В файл сохранятся метки (координаты, описание, подпись, номер, цвет), линии (координаты, описание, цвет) и многоугольники (координаты, описание, цвет).

You can save items from your map to Yandex.Disk using one of the supported file types.

These files can be used to import map points to navigation programs that allow you to import GPS coordinates. You can also use these files with the Yandex.Maps API or to view and save data in other programs (such as Google Earth).

Only information about your map items is saved during exporting.

To export items:

Click on Export in the Map type toolbar:

In the Export map objects form, choose a file type:

Click Save to Yandex.Disk .

Your map items will be saved to Yandex.Disk in the Map Constructor / Export folder in the file format you chose with the name [Map name + Date + Time].

KML (Keyhole Markup Language): an XML-based format. Use this format for importing map items that you created in Map Constructor to a map created using the Yandex.Maps API or Google Earth.

This file type saves placemarks (coordinates, description, label and color), lines, and polygons.

See Displaying GPX and KML in the Yandex.Maps API documentation for an example of using KML files in the Yandex.Maps API.

If you open your file using a program designed for viewing this file type (such as Google Earth), you will see your map items:

XLSX (Microsoft Excel spreadsheet).

This file type saves placemarks (coordinates, description, label). Columns: latitude, longitude, description, label:

CSV (Comma-Separated Values): a text format for presenting tabular data. This file type can be opened in text and table editors.

Text is divided into columns using special separator characters. To select the separator, click the appropriate Separator button: Comma, Semicolon, or Tab.

This file type saves placemarks (coordinates, description, label, number).

Coordinates are stored in the order [latitude, longitude].

If you open your file using a program designed for viewing this file type, you will see your map item data:

GPX (GPS eXchange Format): an XML-based text format for storing and exchanging GPS data. It can be used in GPS apps and the Yandex.Maps API (example) . For example, you can use it to set routes.

This file type saves placemarks and lines (only coordinates for both).

GeoJSON

GeoJSON : a geo-data format based on JSON.

Supported by the Yandex.Maps API, OpenLayers, Leaflet, Bing Maps, and Yahoo! Maps and other cartographic services (example) .

This file type saves placemarks (coordinates, description, label, number, color), lines (coordinates, description, color) and polygons (coordinates, description, color).

Coordinates are stored in the order [latitude, longitude].

You can save items from your map to Yandex.Disk using one of the supported file types.

These files can be used to import map points to navigation programs that allow you to import GPS coordinates. You can also use these files with the Yandex.Maps API or to view and save data in other programs (such as Google Earth).

Only information about your map items is saved during exporting.

To export items:

Click on Export in the Map type toolbar:


In the Export map objects form, choose a file type:


Click Save to Yandex.Disk .

Your map items will be saved to Yandex.Disk in the Map Constructor / Export folder in the file format you chose with the name [Map name + Date + Time].

KML (Keyhole Markup Language): an XML-based format. Use this format for importing map items that you created in Map Constructor to a map created using the Yandex.Maps API or Google Earth.

This file type saves placemarks (coordinates, description, label and color), lines, and polygons.

See Displaying GPX and KML in the Yandex.Maps API documentation for an example of using KML files in the Yandex.Maps API.

If you open your file using a program designed for viewing this file type (such as Google Earth), you will see your map items:


XLSX (Microsoft Excel spreadsheet).

This file type saves placemarks (coordinates, description, label). Columns: latitude, longitude, description, label:


CSV (Comma-Separated Values): a text format for presenting tabular data. This file type can be opened in text and table editors.

Text is divided into columns using special separator characters. To select the separator, click the appropriate Separator button: Comma, Semicolon, or Tab.

This file type saves placemarks (coordinates, description, label, number).

Coordinates are stored in the order [latitude, longitude].

If you open your file using a program designed for viewing this file type, you will see your map item data:


GPX (GPS eXchange Format): an XML-based text format for storing and exchanging GPS data. It can be used in GPS apps and the Yandex.Maps API (example) . For example, you can use it to set routes.

This file type saves placemarks and lines (only coordinates for both).

GeoJSON

GeoJSON : a geo-data format based on JSON.

Supported by the Yandex.Maps API, OpenLayers, Leaflet, Bing Maps, and Yahoo! Maps and other cartographic services (example) .

This file type saves placemarks (coordinates, description, label, number, color), lines (coordinates, description, color) and polygons (coordinates, description, color).

You can import items from a file using one of the following formats:

Create a new map that's designed to import data from a file (data can only be imported to a new map).

You can do this by clicking Import in your map list:

The Import window opens:

Click Select file and select the file that you want to import data from (you can perform a one-time data import from a single file).

The contents of the selected file will be automatically verified for compliance with Attention. \\n

There are certain restrictions on item creation:

A line or polygon can not comprise more than 1,000 vertexes.

If the number of vertexes that an item has exceeds the maximum, then the item may be simplified automatically (i.e. the excess vertexes are deleted, but in such a way as to maintain the overall appearance of the item).

CSV or XLSX files must follow a specific template. You can open this template by clicking the appropriate link at the bottom of the window or find it in the CSV or XLSX sections.

After the import process has completed, data from the file you selected will display on the map you created and may be edited and saved.

If you import data from a KML file, the map will include the following:

Placemarks (coordinates, description, label, color)

Lines (everything that can be set using the Constructor)

Polygons (all settings that can be changed using the Constructor)

If the file's metadata stores map names and descriptions, they will also be imported.

If the source file contains groups, they will not be saved .

The item color will be the closest to the original that is supported by Map Constructor.

Example of results after importing data from a KML file (in English, but other language options are available):

Download the sample file at this link: Sample KML file.

You can also read about the KML format in the Exporting map items section.

When you import data from a GPX file, placemarks are added to the map (coordinates, description, label), along with routes and tracks.

If the file's metadata stores map names and descriptions, they will also be imported.

Example of results after importing data from a GPX file (in English, but other languages are also available):

Download the sample file at this link: Sample KML file.

You can also read about the GPX format in the Exporting map items section.

GeoJSON

When you import data from a GeoJSON file, placemarks (coordinates, description, label, number, color), lines (everything that can be set using the Constructor) and polygons (everything that can be changed using the Constructor) are added to the map.

If the source file contains groups, they will not be saved.

The item color will be the closest to the original that is supported by Map Constructor. Example of results after importing data from a GeoJSON file (in English, but other languages are also available):

Download the sample file at this link: Sample GeoJSON file.

You can also read about the GeoJSON format in the Exporting map items section.

When you import data from a CSV file, only placemarks (coordinates, description, label, number) are added to the map.

API Яндекс Карт

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

Ольга Исаева

Добрый день! я создала карту в конструкторе, не понимаю, как ей пользоваться в приложении яндекс карт. Подскажите, пжл.

API Яндекс Карт

Olga, карты Конструктора можно открыть только в браузере мобильного устройства. В приложении Яндекс.Карт для мобильных карты Конструктора не поддерживаются.

Ольга Исаева

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

API Яндекс Карт

Аваз Каквасов

Добрый вечер! Подскажите можно ли на созданной в конструкторе карте и размещенной на странице сообщества в VK к объекту привязать ссылки на фото и видео размещенные в том же VK.

API Яндекс Карт

Avaz, в балунах объектов, можно использовать html-разметку. Вы можете таким образом добавить нужные ссылки. Что касается правил работы со ссылками самого VK, можно узнать в техподдержке соцсети.

Аваз Каквасов

API Яндекс.Карт, я не понимаю почему все так замысловато и серьезно. Вот к примеру я обычный пользователь, мне нужно разместить в своем сообществе карту города где я отмечу свои торговые точки, к этим меткам я хотел бы привязать видео, фото и текстовые файлы. Зашел такой же пользователь, щелкнул по метке и получил всю необходимую информацию. Кстати, я нашел в сети такую программку называется "Карты" для VK, правда она не работает по причине какой то несогласованности, но вопрос не в этом. Вопрос в том, что кликая по ссылке на странице в контакте даже с мобильного устройства не нужно менять браузер как это происходит в конструкторе яндекс карт, в подвал данной программы просто вставляешь прямые ссылки на видео и фото размещенные в том же Контакте и все. В конструкторе Яндекс карт так сделать сложно? Или тоже какие то несогласованности?

API Яндекс Карт

Avaz, конструктор Карт предназначен для создания простых карт в визуальном редакторе. Если Вам нужны более широкие возможности, такие как интерактивный контент внутри карты, Вы можете использовать html-разметку в Конструкторе. Для контента вне карты и интеграции с элементами сайта понадобится использовать уже JavaScript API (инструмент для разработчиков).
Что касается интеграции с ВКонтакте, то есть ограничения со стороны самой соцсети, например, сторонний разработчик не может добавить свой код в стандартные блоки. К сожалению, про них я ничего рассказать не смогу.

Читайте также: