API обработки Mapflow

API обработки Mapflow позволяет выполнять геопространственный анализ на основе искусственного интеллекта на основе спутниковых и аэрофотоснимков. Используйте его для обнаружения зданий, дорог, лесов и т. д. в большом масштабе.

Внимание

Проекты и обработки, созданные через API, синхронизируются с Mapflow.ai. Вызовы API потребляют ваши кредиты Mapflow.

Базовый URL

https://api.mapflow.ai/rest

Аутентификация

Для всех запросов API требуется токен API. Создайте свой в настройках профиля.

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.mapflow.ai/rest/user/status

Подробности см. в руководстве по авторизации.

Быстрый старт

Запустите первую обработку в 3 этапа:

1. Создать проект

   curl -X POST https://api.mapflow.ai/rest/projects \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "My First Project",
       "description": "Buildings detection"
     }'
   

   Ответ: {"id": "project-uuid", ...}

2. Создание и запуск обработки

   curl -X POST https://api.mapflow.ai/rest/processings/v2 \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "Downtown Buildings",
       "projectId": "project-uuid",
       "wdName": "🏠 Buildings",
       "geometry": {
         "type": "Polygon",
         "coordinates": [[
           [37.6156, 55.7558],
           [37.6256, 55.7558],
           [37.6256, 55.7608],
           [37.6156, 55.7608],
           [37.6156, 55.7558]
         ]]
       },
       "params": {
         "sourceParams": {
           "dataProvider": {
             "providerName": "Mapbox",
             "zoom": 18
           }
         }
       }
     }'
   

   Ответ: {"id": "processing-uuid", "status": "IN_PROGRESS", ...}

3. Проверьте статус и результаты загрузки

   # Check status
   curl https://api.mapflow.ai/rest/processings/{processing-uuid}/v2 \
     -H "Authorization: Bearer YOUR_TOKEN"
   
   # Download results (when status = "OK")
   curl https://api.mapflow.ai/rest/processings/{processing-uuid}/result \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -o results.geojson
   

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