gifts2017

Удобное API для работы с Yandex картами (8.1, с незначительными доработками 8.2) + Пример использования

Опубликовал Валерий Волошин (VVi3ard) в раздел Программирование - Практика программирования

В одном из моих проектов возникла задача: "Отобразить на карте список произвольных адресов".
Я разделил её на 2 части:
1. Создание удобного API.
2. Решение задачи с помощью API.

Вашему вниманию предлагаю API + Пример использования в прикладном решении.

Общее описание

API находится в Модуле обработки, пример использования в модуле формы.

API осуществляет:

  1. Геокодирование (преобразование адреса в координаты).
  2. Генерацию HTML кода для отображения в поле HTML документа.
  3. Поддерживается настройка цвета и вида отображаемой метки.

Принцип работы


1. Получить пустую ТЗ для заполнения с помощью функции: ИнициализироватьТЗАдресов функция в качестве параметров может принять уже существующую ТЗ, в этом случае в ТЗ будут добавлены необходимые колонки (Проверка на существования колонок не осуществляется). 

Структура ТЗ:

  • "Адрес"
  • "Широта"
  • "Долгота"
  • "ТипМетки"
  • "ЦветМетки"
  • "ОписаниеМетки"
  • "ДополнительноеОписание"

2. Заполнить ТЗ добавив адреса которые необходимо отобразить на карте, Широту и Долготу можно не указывать они будут заполнены позже, при вызове функции: "ПолучитьHTMLСУстановленнымиМетками". При желании можно вызвать геокодер отдельно через "ПроверитьИЗаполнитьКоординатыДляАдресовИзИсточника" на вход процедура принимает ТЗ. 

Так же для каждого адреса можно установить тип и цвет метки а так же дополнительную информацию для отображения на карте.

3. Вызвать функцию: ПолучитьHTMLСУстановленнымиМетками - данная функция вернёт код для отображения в поле HTML;

 

Тестовый пример:

Позволяет ввести список адресов в ручную или импортировать его из поля табличного документа (вкладка  Импорт).

 

При разработке использовались материалы с сайта Yandex и исходные коды нескольких похожих обработок с Infostart.

Скачать файлы

Наименование Файл Версия Размер Кол. Скачив.
APIYandexMap+Example
.epf 15,50Kb
22.08.14
332
.epf 15,50Kb 332 Бесплатно

См. также

Подписаться Добавить вознаграждение

Комментарии

1. Денис Кожухов (imozg) 14.11.11 14:42
Симпотично :) А адреса показывает?
2. Валерий Волошин (VVi3ard) 14.11.11 14:48
Показывает текст который указан в колонке "ОписаниеМетки" или "ДополнительноеОписание" (дополнительное применимо не для всех типов меток).
В итоге не кто не мешает при заполнении ТЗ указать адрес в поле "ОписаниеМетки".

Собственно в прикладном решении в эти поля выводится много информации в т.ч. и адрес. В примере я делал минимум всего.
Спасибо за позитивный отзыв.
3. red 80 (red80) 14.11.11 23:07
А можно это на обменник выложить? Например на narod.ru Инфостарт ни скачать, ни посмотреть не дает.
4. Дмитрий Вдовин (vdovinDS) 16.11.11 09:01
5. Игорь Грунин (FroZen) 02.03.12 21:17
Проделанна большая работа. Спасибо.
6. Игорь Игорян (ИгорьИгорян) 02.03.12 21:20
7. Viktor Kupko (zipik) 25.03.12 00:36
8. Сергей Сергей (26178@mail.ru) 14.11.12 02:33
как проверить входит ли точка в многоугольник созданный функцией
var polygon = new YMaps.Polygon([ new YMaps.GeoPoint(37.7,55.7),
new YMaps.GeoPoint(37.7,55.8),
new YMaps.GeoPoint(37.8,55.8),
new YMaps.GeoPoint(37.8,55.7),
new YMaps.GeoPoint(37.7,55.7)
]);

map.addOverlay(polygon);
9. Кирилл Раковский (RakovskiyK) 24.12.12 17:00
почему то картинки не цепляет и как-то криво выделяет адреса, не исключаю кривых рук комментатора, но тем не менее почему то иконки изображений не выводяться.. что делать?

в целом, поняв, что должно получиться - я заранее доволен и заранее большой спасибо автору!
10. Валерий Волошин (VVi3ard) 24.12.12 21:15
(9) RakovskiyK, а что не так? Можешь скриншот показать?
11. Виталий Фантич (Boudybuilder) 05.05.13 15:20
Я вот с работой АРІ новичок.
Только только учусь.
Написал кожд , но что то на Яндекс Диске не авторизируется. Где у меня ошибка?


ЯДиск = Новый HTTPСоединение ("webdav.yandex.ru","443",,,,Истина);
ИмяФайла = ПолучитьИмяВременногоФайла();
ЯДиск.Получить("PROPFIND / HTTP/1.1
|Host: webdav.yandex.ru
|Accept: */*
|Depth: 0
|Authorization: Basic "+мЛогин+" : "+мПароль,ИмяФайла);

Вот не пойму , правильно я делаю или нет?
12. Виталий Фантич (Boudybuilder) 05.05.13 15:21
Я вот с работой АРІ новичок.
Только только учусь.
Написал кожд , но что то на Яндекс Диске не авторизируется. Где у меня ошибка?


ЯДиск = Новый HTTPСоединение ("webdav.yandex.ru","443",,,,Истина);
ИмяФайла = ПолучитьИмяВременногоФайла();
ЯДиск.Получить("PROPFIND / HTTP/1.1
|Host: webdav.yandex.ru
|Accept: */*
|Depth: 0
|Authorization: Basic "+мЛогин+" : "+мПароль,ИмяФайла);

Вот не пойму , правильно я делаю или нет?
А то я весь интернет излазил , и ничего нормально так и не понял.
Может скачаю обработку какую то и на примере посмотрю
13. Вася Неизвестный (dismoitout) 15.06.15 11:30
Здравствутйе .
При попытке запустить в ут 10.3 пишет
что нет процедуры
ПолучитьИмяФайлаВДиалоге
14. simuljakr (simuljakr) 25.08.15 12:20
Здравствуйте.

А позволяет ли данная разработка сохранить расставленные точки, чтобы их могли видеть другие пользователи (уже через браузер)?
15. Валерий Волошин (VVi3ard) 25.08.15 16:12
(14) simuljakr, нет.
Насколько я понимаю вам нужно что то типа такого:
https://static-maps.yandex.ru/1.x/?l=map&lang=ru-RU&ll=30.3139%2C59.93853&origin=jsapi-constructor&pt=30.39%2C59.92613%2Cpm2ntl~30.31518%2C59.93336%2Cpm2ywl&size=600%2C450&z=12

В обработке используется JavaScript API а для Вашей задачи нужен: https://tech.yandex.ru/maps/tools/constructor/

В общем то переделать обработку для того что бы она генерировала ссылку а не HTML формат ссылки:
pt=PlacemarkDefinition1~PlacemarkDefinition2~PlacemarkDefini­tion3...
Подробнее https://tech.yandex.com/maps/doc/staticapi/1.x/dg/concepts/markers-docpage/

Для доработки можно оставить часть геокодера как есть а часть отвечающую за формирование JavaScript переделать на формирование ссылки.

simuljakr; +1 Ответить
Для написания сообщения необходимо авторизоваться
Прикрепить файл
Дополнительные параметры ответа