Документация
JavaScript API 1.x
Руководство разработчика
Справочник по программному интерфейсу

Подготовка тайлов для пользовательского слоя карты

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

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

Для того, чтобы использовать изображение в качестве пользовательского слоя Яндекс.Карт, его необходимо предварительно подготовить. Подготовка изображения включает в себя два этапа:

  1. Привязка изображения к географическим координатам (совмещение изображения с картой).

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

  2. Формирование наборов тайлов.

    Привязанное к координатам изображение требуется нарезать на фрагменты (тайлы) размером 256x256 пикселов. Каждый тайл хранится в отдельном файле (JPEG или PNG). Для каждого значения коэффициента масштабирования должен быть сформирован свой набор тайлов.

Приложение "Подготовка слоя тайлов"

Приложение "Подготовка слоя тайлов" позволяет автоматизировать процесс подготовки произвольного изображения для показа на веб-странице с помощью API Яндекс.Карт.

Приложение позволяет полностью автоматизировать решение следующих задач:

  • нарезка тайлов с привязкой по координатам -- на изображение наносятся точки привязки, устанавливается соответствие пиксельных координат географическим, изображение перепроецируется под привязку и нарезается на тайлы. Полученные тайлы могут использоваться в качестве источника данных для пользовательского слоя карты (см. YMaps.TileDataSource).
  • нарезка тайлов без привязки по координатам -- изображение сразу нарезается на тайлы для отображения с помощью API (например, для просмотра фотографий и планов).
  • создание кода HTML-страницы с готовой картой для размещения на сайте.

Скачать приложение "Подготовка слоя тайлов"

Ограничение. 

Приложение доступно только для операционной системы Microsoft Windows.

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

Чтобы подготовить и опубликовать пользовательский слой карты с помощью приложения "Подготовка слоя тайлов" выполните следующие шаги:

  1. Загрузите приложение и сохраните его на диск.

  2. Откройте изображение (в меню Файл выберите команду Открыть изображение).

    Исходное изображение может быть в одном из следующих форматов: PNG-8, PNG-24, JPEG, GIF, TIFF или BMP.

  3. Если изображение должно быть привязано к участку земной поверхности, установите флажок Привязка, расставьте на изображении точки привязки и задайте их географические координаты (долготу и широту).

    Для определения координат точек используйте инструмент Определение координат.

  4. Экспортируйте изображение в требуемый каталог. Необходимые наборы тайлов и HTML-код карты будут сформированы автоматически.

  5. Загрузите полученные тайлы и HTML-код карты на сайт.

Управление точками привязки

Внимание! Чтобы перейти в режим редактирования геопривязанного изображения, установите флажок Привязка.

Привязка изображения к участку земной поверхности осуществляется по 4-м (или более) точкам, расставленным, как правило, по углам изображения. Каждая точка привязки имеет две пары координат: пиксельные координаты (X и Y) и географические (широта и долгота).

Начало отсчета пиксельных координат находится в верхнем левом углу изображения, X – номер пикселя по горизонтали, Y – по вертикали.

Географические координаты точек привязки задаются в десятичном формате. Например, для долготы 34°30' десятичное значение составляет 34.5.

Совет. Для определения широты и долготы точек используйте инструмент Определение координат.

Создание точки привязки

Чтобы создать точку привязки на изображении:

  1. Нажмите кнопку Добавить.

  2. Щелкните место на изображении, где необходимо расположить новую точку привязки.

  3. В таблице точек привязки задайте широту и долготу точки.

    Примечание. В инструменте Определение координат в поле Координаты метки первое число – это долгота, второе – широта.

Перемещение точки привязки

Точки привязки можно перетаскивать мышью.

Удаление точки привязки

Чтобы удалить точку привязки, щелкните по ней кнопкой мыши или выберите в таблице точек соответствующую строку, а затем нажмите кнопку Удалить.

Сохранение точек привязки в файл

Чтобы сохранить созданные точки привязки в файл (XML, TXT или CSV), в меню Файл выберите команду Сохранить точки.

Экспорт изображения

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

Приложение "Подготовка слоя тайлов" позволяет экспортировать в виде карты как все изображение целиком (по умолчанию), так и выделенную прямоугольную область. Область экспорта отмечается на изображении синей рамкой (изначально включающей в себя все изображение). Чтобы получить возможность изменить границы области, щелкните по рамке кнопкой мыши.

Чтобы экспортировать изображение в виде наборов тайлов и HTML-кода карты:

  1. В меню Файл выберите команду Экспорт карты. Откроется диалоговое окно, в котором требуется задать параметры экспорта тайлов (см. список параметров ниже).

  2. Нажмите Готово. Если изображение имеет большие размеры, то его преобразование и формирование тайлов могут занять несколько минут.

Параметры экспорта тайлов

Каталог для сохранения тайлов
Папка, в которой будут созданы файлы тайлов и HTML-файл с кодом карты.
Маска имен файлов тайлов
Задает правила формирования имен тайловых файлов. Вместо символов %z в имя файла подставляется коэффициент масштабирования, для которого предназначен тайл, вместо %x и %y – координаты тайла. Например, если задана маска %z\tile-%x-%y.png, то тайл с координатами (43797;20185) для 16-го масштаба будет сохранен в подпапку 16 под именем tile-43797-20185.png.
Формировать HTML-код карты в файле
Установите флажок, если кроме тайлов требуется сформировать HTML-код карты в отдельном файле.
Масштабные уровни
Максимальное значение коэффициента масштабирования и общее количество его возможных значений, для которых требуется сформировать тайлы. Например, если необходимы тайлы для уровней с 0 по 16, выберите в раскрывающемся списке Максимальный масштаб значение 16, а в списке Количество уровней – 17. Для геопривязанных изображений максимальный возможный масштаб определяется автоматически. Если требуется экспортировать привязанное изображение в большем масштабе, то следует увеличить его размер в графическом редакторе.
Формат файлов тайлов
Тайлы могут быть экспортированы в один из двух форматов: JPEG или PNG-24.
Цвет для заполнения пустот
Задайте цвет для заполнения пустот, если выбран формат экспорта JPEG. Данный параметр определяет, каким цветом должны быть заполнены прозрачные участки исходного изображения, а также прозрачные области, которые могут образоваться при повороте изображения во время преобразования.
Прозрачность
Задайте прозрачность, если выбран формат экспорта PNG. Если пользовательский слой будет отображаться поверх одного из стандартных слоев карты (Схема, Спутник или Гибрид), то тайлы следует сделать полупрозрачными.
API-ключ Яндекс.Карт
Уникальный API-ключ, полученный для сайта, на котором будет размещена карта.
Название слоя тайлов
Имя пользовательского слоя, которое будет отображаться в элементе управления "Выбор типа карты".
Слой-подложка под слоем тайлов
Название слоя Яндекс.Карт, поверх которого будет отображаться созданный пользовательский слой.
Элементы управления Яндекс.Карт
Названия стандартных элементов управления, которые будут доступны на сформированной карте.