При интеграции систем 1С с внешними картографическими сервисами разработчики часто сталкиваются с трудностями при формировании запросов. Одной из самых распространенных проблем является получение ошибки 404 Not Found или пустых ответов от сервера при попытке получить координаты по адресу. В данной статье мы детально разберем, как правильно организовать взаимодействие с Геокодером Яндекс.Карт, устраним типичные ошибки в версиях API и научимся корректно обрабатывать полученные данные.
Первое и самое важное, что нам необходимо прояснить, — это различие между типами API, которые предоставляет Яндекс. В обсуждениях часто возникает путаница: разработчики пытаются использовать версию 2.1 в строке запроса через HTTPСоединение. Проанализируем, почему это приводит к ошибке 404.
Версия 2.1 относится исключительно к JavaScript API. Она предназначена для работы внутри браузера или поля HTML-документа на форме 1С, чтобы отображать интерактивные карты, ставить метки и рисовать маршруты. Если же мы хотим получить координаты (широту и долготу) «в фоне», используя программный код 1С, нам нужен HTTP Geocoder API. Актуальная версия этого сервиса на текущий момент имеет индекс 1.x.
Таким образом, если в вашем коде фигурирует адрес типа geocode-maps.yandex.ru/2.1/, сервер вернет 404, так как по этому пути обработчик HTTP-запросов отсутствует. Правильный базовый адрес всегда должен начинаться с geocode-maps.yandex.ru/1.x/.
Современные требования безопасности обязывают использовать протокол HTTPS. Для этого в 1С мы должны использовать объект ЗащищенноеСоединениеOpenSSL. Рассмотрим правильную структуру инициализации соединения. Выясним причину, по которой старые методы через WinHttp.WinHttpRequest могут работать нестабильно: они зависят от настроек системы и версии Windows, в то время как встроенные средства 1С более универсальны.
Разберем пример кода для создания соединения:
// Инициализируем защищенное соединение
Защита = Новый ЗащищенноеСоединениеOpenSSL();
// Создаем HTTP-соединение с сервером Яндекса
// Используем стандартный порт 443 для HTTPS
Соединение = Новый HTTPСоединение("geocode-maps.yandex.ru", 443, , , , , Защита);
После того как соединение установлено, нам нужно передать параметры. Рассмотрим подробнее состав строки запроса. Одной из критических ошибок является передача кириллицы в «чистом» виде. Любой адрес, содержащий пробелы или русские буквы, должен быть закодирован в формат URL-encoded.
Для этого в 1С предусмотрена функция КодироватьСтроку. Если ее не использовать, запрос будет обрываться на первом же пробеле, и сервер либо выдаст ошибку, либо не найдет объект. Посмотрим на правильный алгоритм формирования параметров:
// Обязательные параметры
КлючAPI = "ваш_ключ_из_кабинета_разработчика";
АдресТекст = "Москва, Красная площадь, д. 1";
// Кодируем строку адреса для передачи в URL
ЗакодированныйАдрес = КодироватьСтроку(АдресТекст, СпособКодированияСтроки.КодировкаURL);
// Собираем строку ресурса
// Обратите внимание на параметр apikey и lang
ПутьЗапроса = "/1.x/?apikey=" + КлючAPI + "&geocode=" + ЗакодированныйАдрес + "&format=json&lang=ru_RU";
Запрос = Новый HTTPЗапрос(ПутьЗапроса);
Результат = Соединение.Получить(Запрос);
Проанализируем ситуацию: иногда код состояния возвращается 200 (ОК), но координаты отсутствуют. Часто это связано с тем, что не указан обязательный параметр lang (язык ответа). Согласно документации Яндекса, параметр lang рекомендуется указывать всегда, например ru_RU, чтобы избежать неоднозначности при поиске объектов в разных регионах.
Также обратите внимание на параметр format=json. По умолчанию Геокодер возвращает данные в формате XML. Чтение XML в 1С через поиск подстрок (как предлагалось в некоторых сообщениях форума) — это крайне ненадежный метод. Если Яндекс изменит хотя бы один атрибут в структуре XML, ваш код перестанет работать. Мы рекомендуем запрашивать JSON и использовать встроенные средства 1С для его парсинга.
Вместо использования функции Найти() и вырезания кусков текста по индексам (что часто приводит к ошибкам при смещении данных), разберем, как прочитать результат цивилизованно. Посмотрим на пример обработки JSON-ответа:
Если Результат.КодСостояния = 200 Тогда
ЧтениеJSON = Новый ЧтениеJSON;
ЧтениеJSON.УстановитьСтроку(Результат.ПолучитьТелоКакСтроку());
ДанныеJSON = ПрочитатьJSON(ЧтениеJSON);
ЧтениеJSON.Закрыть();
// Проходим по структуре ответа Яндекса
// Ответ содержит иерархию: response -> GeoObjectCollection -> featureMember
Попытка
СписокОбъектов = ДанныеJSON.response.GeoObjectCollection.featureMember;
Если СписокОбъектов.Количество() > 0 Тогда
// Берем первый (самый точный) найденный объект
КоординатыСтрокой = СписокОбъектов[0].GeoObject.Point.pos; // Вернет строку "Долгота Широта"
МассивКоординат = СтрРазделить(КоординатыСтрокой, " ");
Долгота = МассивКоординат[0];
Широта = МассивКоординат[1];
Сообщить("Широта: " + Широта + ", Долгота: " + Долгота);
Иначе
Сообщить("Адрес не найден");
КонецЕсли;
Исключение
Сообщить("Ошибка парсинга ответа: " + ОписаниеОшибки());
КонецПопытки;
КонецЕсли;
Если вы все еще получаете ошибки, проанализируем следующие моменты:
HTTPСоединение должен быть инициализирован с параметрами прокси, иначе запрос просто не выйдет во внешнюю сеть.sco в документации, если вам нужен специфический порядок.Используя данный подход с применением актуальной версии API (1.x), обязательным кодированием строки адреса и парсингом через JSON, вы обеспечите стабильную и надежную работу интеграции 1С с геосервисами Яндекса.