Адресные данные, готовые для вашей системы

API геокодирования адресов

Преобразуйте адреса в координаты и нормализованные данные для логистики, электронной торговли, CRM и пространственного анализа.

Одиночные и пакетные запросыПрямое и обратное геокодированиеКачество совпадения в ответе
Domaniewska 37, Warszawa52.18284, 21.0071318

От текста к решениям

Сам адрес не сообщает системе, где находится объект

Геокодирование добавляет к адресным данным пространственный слой. Благодаря этому можно рассчитывать расстояния и маршруты, анализировать зоны обслуживания и показывать объекты на карте.

01

Данные, готовые к работе

Преобразуйте адрес в координаты для карты, CRM, плана доставки или анализа покрытия.

02

Меньше ручных исправлений

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

03

Точнее пространственные решения

Назначайте клиентов филиалам и работайте с точкой вместо неструктурированного текста.

Простой процесс

От адреса к точке за три шага

Один и тот же подход работает в форме, при импорте данных и в автоматической серверной интеграции.

  1. 1

    Отправьте адрес

    Объект address должен содержать city. country и street необязательны; если country отсутствует или равен null, по умолчанию используется PL. pcode и house помогают уточнить совпадение.

  2. 2

    Получите совпадение

    API возвращает координаты, нормализованный адрес и данные для оценки качества совпадения.

  3. 3

    Используйте точку

    Сохраните её, покажите на карте или передайте в маршруты, матрицы и пространственный анализ.

От сценария к контракту

Перейдите прямо от объяснения к рабочему запросу

Страница геокодирования связывает бизнес-сценарий с параметрами метода, качеством ответа и готовым кодом.

  • Geocoder.geocode для одиночных адресов
  • Geocoder.geocodemulti для пакетов
  • Geocoder.revgeocode для координат
  • интерпретация quality и resultRadius
Открыть справочник геокодирования
cURL
curl -X POST https://api.automapa.com/v3/Geocoder/geocode \
  -H "Content-Type: application/json" \
  -H "Session-Id: $AUTOMAPA_SESSION" \
  -d '{
    "address": {
      "country": "PL",
      "city": "Warszawa",
      "street": "Domaniewska",
      "house": "37",
      "maxResult": 1
    }
  }'
200 OK — полная оболочка ответа{ "result": [ { "quality": 9, "x": 21.0071318, "y": 52.18284, "city": "Warszawa", "street": "Domaniewska", "house": "37", "resultRadius": 0 } ] }Значения в примере иллюстрируют формат ответа. Координаты и адресные данные зависят от входных и актуальных картографических данных.

Методы и связанные сервисы

Геокодирование часто становится первым этапом большого процесса

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

Пакетное геокодирование

Geocoder.geocodemulti

Обрабатывайте несколько адресов одним запросом.

Документация

Обратное геокодирование

Geocoder.revgeocode

Преобразуйте координаты в ближайший понятный адрес.

Документация

Адресные подсказки

Autocomplete.searchAddress

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

Документация

Маршруты и матрицы

Routes.route / Routes.matrix

Используйте геокодированные точки для расчёта времени и расстояний.

Документация

Сценарии

Геокодирование — часть процесса, а не конечная цель

Логистика

Подготовьте адреса погрузки и доставки для расчета маршрутов и планирования доставок.

Электронная торговля

Проверяйте местоположение заказов и сокращайте ручные исправления адресов.

Торговые сети

Находите ближайший филиал и распределяйте клиентов по регионам.

Качество данных

Нормализуйте исторические адресные базы перед миграцией или анализом.

Частые вопросы

Основы геокодирования перед интеграцией

Что такое геокодирование?

Геокодирование преобразует описание адреса в географические координаты, которые можно показать на карте или использовать в геопространственных процессах.

Какие поля обязательны?

Объект address и его поле city обязательны для каждого адреса, включая пакетные запросы. country и street необязательны; если country отсутствует или равен null, по умолчанию используется PL. pcode и house могут повысить точность.

Как оценить результат?

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

Можно ли обработать много адресов?

Да. Метод Geocoder.geocodemulti предназначен для пакетной обработки адресов.

Предпросмотр обращается к рабочему API?

Нет. Он показывает пример ответа, а документация объясняет, как выполнить аутентифицированный запрос к API.