Интеграция Яндекс.Карт в веб-приложении на React/TypeScript

Аннотация

В статье рассматривается реализация интеграции сервиса Яндекс.Карты в одностраничное веб-приложение, разработанное на основе React и TypeScript. Описывается подход к динамической загрузке JavaScript API Яндекс.Карт, инициализации карты в компоненте Admission, а также обработке типовых ошибок, связанных с загрузкой скрипта и готовностью DOM-элементов. Особое внимание уделяется использованию глобального объекта window.ymaps в контексте типизации TypeScript, управлению состояниями загрузки карты и ошибок через хуки useState и useEffect, а также организации пользовательского интерфейса с индикацией процесса загрузки и сообщений о недоступности карты. Реализация выполнена с использованием демо-доступа к API без явного использования ключа, что позволяет обеспечить базовую функциональность для отображения местоположения организации.