Введение в API Яндекс.Карт

Общие сведения

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

Компоненты API.Яндекс Карт

JavaScript API — интерфейс для размещения интерактивных карт.
Static API — интерфейс для размещения статических изображений карт.
Геокодер — сервис для поиска географических объектов на карте.
YMapsML — XML-язык для описания географических данных.

Доступ к API Яндекс.Карт осуществляется с помощью API-ключа. Чтобы его получить, необходимо заполнить специальную форму. Подробнее, что такое API-ключ, читайте на странице «Вопросы и ответы».

Размещение карт на веб-страницах

На веб-странице можно разместить интерактивную или статическую карту. Интерактивная карта (Javascript API) позволяет посетителям веб-страницы взаимодействовать с картой при помощи элементов управления.

JavaScript API. Интерактивная карта. Тип: Гибрид

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

Статическая карта (Static API) – это простое изображение карты, подходящее для большинства сайтов.

Static API. Статическое изображение. Тип: Схема

Статические изображения карт формируются с помощью HTTP-запросов.

Для размещения статической или интерактивной карты на веб-странице необходимо указать три основных параметра: тип карты, её масштаб и центр (см. Параметры карты).

Добавление объектов на карту

Карту дополняют графические объекты, которые накладываются на изображение местности.

Интерактивная карта (Javascript API) дополняется метками, ломаными линиями, многоугольниками и балуном. Для описания объектов на карте применяется YMapsML.

Изображение статической карты дополняют метки, ломаные линии и многоугольники.

Поиск по карте

API Яндекс.Карт позволяет находить объекты по их названиям или адресу. Эту задачу выполняет сервис Геокодер.

Например, по запросу «Москва, ул. Малая Грузинская, д. 27/13» геокодер вернет метку с географическими координатами этого дома (37.571309, 55.767190), которую сразу же можно поместить на карту.

Географические координаты

При размещении на карте объекта необходимо указать его географические координаты.

Для этого нужно задать долготу и широту. Например: 37.571309, 55.767190.

Параметры карты

Основными параметрами карты являются тип, центр, масштаб и размер. От размера и масштаба зависит, какой будет область показа карты на веб-странице.

Тип

API Яндекс.Карт позволяет работать с тремя типами карт:

«Схема» (MAP) – традиционное представление карты. Используется по умолчанию.
«Спутник» (SATELLITE) – спутниковые снимки местности.
«Гибрид» (HYBRID) – карта, в которой на спутниковые снимки нанесены названия географических объектов.

Тип: Схема, Спутник, Гибрид

Инструментарий (Javascript API) предназначен для создания и размещения собственных карт, с изображением любых объектов, не только географических (открыть пример в браузере).

Центр

Центр отображаемого участка карты задается с помощью географических координат. Например, географические координаты центра Москвы: 37.620070, 55.753630.

Масштаб

Масштаб карты показывает, насколько длина линии на карте меньше соответствующей ей длины на местности.

API Яндекс.Карт поддерживает 17 уровней масштабирования. При уровне масштабирования 1 на карте видны все континенты. На каждом следующем уровне масштаб удваивается. Так, на 17 уровне масштабирования видны отдельные здания.

Размер

Размер — это ширина и высота карты, в пикселах.

Максимально возможный размер статической карты – 600x450 пикселов.

Интерактивная карта по размеру не ограничена.

Статическое изображение. Тип: Схема. Размер: 200х200 и 450х150 пикселов