Ошибки и диагностика

Как понять, почему запрос или карта не сработали.

Ошибки API

В JavaScript ошибки RoutingApiError / PlacesApiError содержат status, message и иногда code. Во Flutter UMapApiException содержит statusCode, message и code. Сетевые ошибки и отмена запроса могут иметь другой тип.

Статус	Что проверить
	Что проверить
400	Параметры: координаты, город, режим транспорта и число точек.
401	Ключ отсутствует или не принят.
403	Права на карту/API, origin и срок ключа.
402	Доступный баланс сервиса.
429	Лимит запросов; прекратите частые повторы.
5xx	Ошибка сервиса; предложите повторить позже.

Карта пустая

Проверьте высоту контейнера, Style URL и ключ. Откройте ошибки сети в инструментах разработчика. Для iOS/Android используйте доступный устройству HTTPS-адрес сервера. localhost на физическом телефоне означает сам телефон.

Слой не виден

Добавляйте источник до слоя и после загрузки стиля. Проверьте source-layer для MVT, порядок долготы и широты, текущий масштаб и minzoom/maxzoom слоя. Для Polygon замкните кольцо, повторив первую координату последней.