cablate/mcp-google-map

Получает качество воздуха для местоположения — индекс AQI, концентрации загрязнителей и рекомендации по здоровью для разных групп населения (пожилые, дети, спортсмены, беременные и т.д.). Используйте, когда пользователь спрашивает «безопасен ли воздух», «стоит ли носить маску», «хорошо ли для занятий на улице» или планирует поездку для человека с проблемами дыхания или сердца. Покрытие: глобальное, включая Японию (в отличие от погоды). Возвращает как универсальный AQI, так и локальный индекс (EPA для США, AEROS для Японии и т.д.).

Геокодирует несколько адресов за один вызов — до 50 адресов, возвращает координаты каждого. Используйте, когда пользователь передаёт список адресов и нужны координаты всех, например «геокодируй эти 10 офисов» или «получи координаты для всех этих ресторанов». Если адресов больше 50, используйте вместо этого команду CLI batch-geocode.

Сравнивает несколько мест бок о бок за один вызов: ищет по запросу, получает детали по каждому результату и опционально вычисляет расстояние от вашего местоположения. Используйте, когда пользователь спрашивает «какой ресторан выбрать», «сравните эти отели» или просит таблицу для принятия решений. Заменяет ручную цепочку search-places → place-details → distance-matrix.

Получает пошаговые инструкции по навигации между двумя точками с деталями маршрута. Используйте, когда пользователь спрашивает «как добраться из A в B?» и нужна сводка маршрута, общее расстояние, расчетное время в пути или пошаговые инструкции. Поддерживает время отправления/прибытия и несколько режимов передвижения.

Рассчитывает расстояния и время в пути между несколькими точками отправления и назначения в одном запросе. Используйте для сравнения вариантов поездки, например, «какая гостиница ближе всего к офису?» или пакетных расчетов расстояний. Поддерживает режимы передвижения: на автомобиле, пешком, на велосипеде и общественным транспортом.

Получает высоту над уровнем моря для географических координат. Используйте, когда пользователь спрашивает «какая высота у этого места», «подвержена ли эта местность наводнениям» или нужна высота для профилей пеших или велосипедных маршрутов. Также пригодится для оценки рисков недвижимости — низкая высота рядом с водой указывает на риск наводнения.

Исследует окрестности одной командой — ищет по нескольким типам мест, получает подробности по лучшим результатам и возвращает категоризированную сводку. Используй, когда пользователь спрашивает «что здесь рядом», «изучи район рядом с моим отелем» или хочет быстро понять, что за место. Заменяет ручную цепочку geocode → search-nearby → place-details. Для планирования поездки: сначала используй search_places, чтобы получить географически разнесённые точки, потом вызывай этот инструмент около каждой точки (например, «Гион, Киото») — никогда не передавай просто название города, иначе все результаты соберутся в одном месте. После результатов вызывай static_map для визуализации.

Преобразует адрес, название города или ориентир в GPS-координаты (широта/долгота). Используйте, когда нужны координаты для места, описанного в тексте - например, чтобы задать центр для search_nearby или начальную точку для maps_directions.

Отслеживает рейтинг бизнеса в локальном поиске по географической сетке (как LocalFalcon). Выполняет поиск по одним и тем же ключевым словам из нескольких координат вокруг центральной точки, чтобы увидеть, как меняется позиция в зависимости от местоположения. Поддерживает до 3 ключевых слов для пакетного сканирования. Возвращает позицию в каждой точке сетки, топ-3 конкурентов по каждой точке и сводные метрики (ARP, ATRP, SoLV). Полезно для анализа локального SEO.

Получает подробные сведения о конкретном месте по его Google Maps place_id. Используйте после search_nearby или maps_search_places, чтобы получить отзывы, телефон, веб-сайт и часы работы. Отзывы, фотографии и AI-сводки содержат метаданные об источнике/раскрытии, которые должны сопровождать отображение конечному пользователю. Установите maxPhotos (1-10), чтобы включить URL фотографий; не указывайте его или установите 0, чтобы исключить фотографии.

Планирует оптимизированный маршрут с несколькими остановками одним вызовом: геокодирует все остановки, использует оптимизацию путевых точек Routes API (от 2 до 25 промежуточных остановок), чтобы найти наиболее эффективный порядок посещения, и возвращает маршрут для каждого участка. Используйте, когда пользователь говорит «обойди эти 5 мест эффективно», «построй маршрут через A, B, C» или ему нужен маршрут с несколькими остановками. Заменяет ручную цепочку геокодирование → матрица расстояний → маршрут. Оптимизация путевых точек требует минимум 4 остановок (2 промежуточных); при 2 или 3 остановках маршрут возвращается в исходном порядке. Для поездок на несколько дней: создавайте один вызов plan_route на каждый день с остановками, которые следуют географической дуге (например, с востока на запад), а не смешивайте удалённые районы. После получения результатов вызовите static_map, чтобы визуализировать маршрут.

Преобразует GPS-координаты (широту/долготу) в человекочитаемый почтовый адрес. Используйте, когда у вас есть координаты из вывода другого инструмента или переданная пользователем геопозиция, и нужен фактический адрес.

Ищет места вдоль маршрута между двумя точками: рестораны, кафе, заправки и т.д., отсортированные по минимальному времени отклонения от маршрута. Используется для планирования поездки, чтобы находить еду, места отдыха или достопримечательности между ориентирами без возврата назад. Внутренне вычисляет маршрут, затем ищет вдоль него. Незаменим для построения маршрутов, где остановки должны ощущаться как «по пути», а не как «объезд».

Находит места рядом с указанным местоположением по типу (например, рестораны, кафе, отели). Используйте, когда пользователь хочет узнать, что находится рядом с заданным адресом или координатами — например, «найди кофейни рядом с Times Square» или «какие отели рядом с аэропортом». Поддерживает фильтрацию по типу места, радиусу поиска, минимальному рейтингу и по признаку «открыто сейчас».

Ищет места по свободному текстовому запросу, например 'sushi restaurants in Tokyo' или 'best coffee shops near Central Park'. Более гибкий, чем search_nearby — поддерживает запросы на естественном языке, опциональную привязку к местоположению, фильтры по рейтингу и фильтр «открыто сейчас». Используйте, когда пользователь описывает, что ищет, словами, а не по типу и координатам.

Создает карту с маркерами, путями или маршрутами — результат возвращается в виде встроенного изображения, которое пользователь видит прямо в чате. ВЫЗЫВАЙ этот инструмент после explore_area, plan_route, search_nearby или directions, чтобы визуализировать результаты на карте — не жди, пока пользователь попросит. Используй маркеры из результатов поиска и путь из данных маршрута. Поддерживает режимы: дорожная карта, спутник, рельеф и гибрид. Максимум 640×640 пикселей.

Получить часовой пояс и текущее местное время для местоположения. Используйте, когда пользователь спрашивает «сколько времени в Токио», нужно согласовать встречу в разных часовых поясах или планируется поездка через границы часовых поясов. Возвращает timezone ID, смещения UTC/DST и вычисленное местное время.

Получает погоду для местоположения: текущие условия, дневной прогноз (10 дней) или почасовой прогноз (240 часов). Используйте, когда пользователь спрашивает «какая погода в Париже», планирует мероприятия на улице или собирает чемодан в поездку. Покрытие: поддерживается большинство регионов, но Китай, Япония, Южная Корея, Куба, Иран, Северная Корея, Сирия недоступны.