Глоссарий терминов

Содержит определения специальных терминов, которые обозначают базовые понятия API Яндекс.Карт.

API

API — программный интерфейс приложения (англ. Application Programming Interface).

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

Подробнее о термине «API» можно прочитать в Википедии.

API-ключ

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

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

Ключ, зарегистрированный на отдельный домен, будет действителен для всех URL этого домена и поддоменов, всех протоколов и всех портов. Например, ключ, зарегистрированный на домен http://www.mydomain.com/, будет действителен для:

• http://www.mydomain.com/

• http://www.mydomain.com/mysite/

В то же самое время, этот ключ будет недействителен для:

• http://mydomain.com/

• http://host1.mydomain.com/

• http://host2.mydomain.com/mysite/

Ключ, зарегистрированный на домен http://mydomain.com/ будет действителен для всех вышеупомянутых URL.

Балун

Балун — всплывающее окно с клиновидным хвостиком, указывающим в определенную точку на карте. Над любой картой Яндекса можно показать один балун с текстом, картинкой или любым другим HTML-содержимым. Балун, например, открывается при щелчке кнопкой мыши по метке. Балун является оверлеем.

Геообъект

Геообъект — объект карты, местоположение которого задается парой (или несколькими парами) координат. Геообъектами, например, являются геоточка, линия и ломаная.

Геообъектам можно присваивать стили и объединять их в группы. Геообъекты интерактивны - у каждого могут быть заданы всплывающая подсказка и балун.

Геоточка

Геоточка — точка, заданная широтой и долготой в системе географических координат. Геоточки могут быть двух видов:

• обычные — с широтой в пределах от -90 до 90 градусов и долготой в пределах от -180 до 180 градусов;

• неограниченные — с широтой в пределах от -90 до 90 градусов и неограниченной на западе и востоке долготой.

См. Типы координат и их преобразование.

Геокодирование и геокодер

Геокодирование — процесс определения координат и дополнительных сведений о географическом объекте по его названию или адресу. Доступ к геокодеру предоставляется как посредством JavaScript, так и по HTTP.

См. Описание геокодера.

Значок метки

Значок (англ. icon) задает изображение метки на карте. Значок состоит из наложенных друг на друга картинок значка и его тени, которые располагаются на заданном смещении от метки.

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

См. Создание пользовательского значка метки.

Координаты

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

• локальные пиксельные координаты (local pixels) — начало координат находится в левой верхней точке контейнера карты, координаты растут по направлению к правому нижнему углу карты;

• пиксельные координаты окна браузера (client pixels) — начало координат находится в левой верхней точке рабочей зоны окна браузера, координаты растут по направлению к правому нижнему углу окна браузера;

• пиксельные координаты карты (map pixels) — начало координат находится в левой верхней точке контейнера слоев карты. Координаты растут вправо и вниз от точки начала координат;

• географические координаты (geo coordinates) — соответствуют общепринятой мировой системе географических координат. Каждая точка в данной системе (геоточка) описывается двумя координатами: широтой и долготой.

См. Типы координат и их преобразование.

Линейный масштаб

Линейный масштаб (англ. scale line) на географических картах - мерная линейка, позволяющая, не прибегая к вычислениям, измерять расстояние между объектами. На картах Яндекса — это элемент управления, отображаемый внизу карты, который предназначен для тех же самых целей. Линейный масштаб автоматически пересчитывается при изменении масштаба карты или географической широты ее центра.

Линия

Линия (англ. line) — отрезок на карте, который задается пиксельными координатами его начала и конца. Линия является оверлеем.

Ломаная

Ломаная (англ. polyline) — последовательность линий и дуг, соединяющих ряд точек на карте. Ломаные используются, например, для построения маршрутов. Ломаная является оверлеем.

Метка

Метка (англ. marker, placemark) обозначает точку на карте. На карте метка может обозначаться с помощью значка. Метки интерактивны — они могут отвечать на щелчок кнопкой мыши и их можно перетаскивать по карте.

См. Метка.

Область показа

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

Для большинства геообъектов область показа - это описанный вокруг объекта прямоугольник.

Оверлей

Оверлей (англ. overlay) — объект, отображаемый поверх карты. Оверлеи перемещаются при перетаскивании или масштабировании карты. Например, оверлеями являются балун, метка, линия и ломаная.

Слой

Слой — область на карте, набранная из тайлов (прозрачных или с изображением), на которой могут располагаться различные объекты. Слой также может содержать и пользовательскую карту целиком.

См. Создание пользовательского слоя карты.

Тайл

Тайл (англ. tile, плитка) — квадратный участок изображения карты в определенном разрешении. Карта Яндекса, подобно мозаике, сложена из тайлов, состыкованных без видимых швов. При изменении масштаба карта вновь набирается из подходящих по разрешению тайлов.

Шаблон

Шаблон (англ. template) — заготовка для создания фрагментов HTML-кода. Помимо HTML, шаблон содержит специальные переменные, которые при его разборе подменяются указанными данными. Шаблоны могут использоваться, например, при создании содержимого пользовательских значков и балуна.

См. Стили, шаблоны и макеты.