Установка скиллов и плагинов OpenClaw осуществляется на ваш страх и риск. Все файлы были получены из открытых источников и предоставляются «как есть». Мы не гарантируем их корректную работу, безопасность или совместимость с вашей системой. Перед установкой настоятельно рекомендуется ознакомиться с содержимым кода и убедиться, что вы понимаете, какие изменения будут внесены в вашу систему.
Amap (Gaode Maps) — это мощный геопространственный навык для экосистемы OpenClaw, который предоставляет AI-агентам доступ к данным о местоположении, погоде и маршрутах в реальном времени.
С его помощью разработчики могут значительно расширить возможности своих агентов, добавив пространственное мышление: от определения координат до планирования поездок и поиска объектов инфраструктуры.
Что такое Amap (Gaode Maps)?
Amap — это интеграция с веб-сервисами Gaode Maps, которая позволяет AI-агентам взаимодействовать с географическими данными и сервисами картографии. Навык выступает мостом между пользовательскими запросами и структурированными данными одной из ведущих картографических платформ.
Используя этот инструмент, агент переходит от обработки текста к реальным действиям: может находить ближайшие объекты, анализировать регионы или строить маршруты.
Основные возможности
- Получение текущей погоды и прогноза по регионам
- Поиск мест (POI) по ключевым словам
- Построение маршрутов между точками
- Преобразование адресов в координаты и обратно
- Работа с административным делением (города, районы, улицы)
Как работает навык
Процесс взаимодействия строится следующим образом:
- Агент распознаёт запрос пользователя, связанный с геолокацией
- При необходимости адрес преобразуется в координаты через геокодирование
- Для погодных запросов определяется adcode региона
- Отправляется запрос к API Amap с использованием ключа AMAP_KEY
- Полученный JSON обрабатывается и преобразуется в удобный ответ
В результате пользователь получает готовую информацию: температуру, расстояние, названия объектов или маршрут.
Настройка
Для использования навыка необходимо получить API-ключ веб-сервиса Amap через официальную платформу разработчиков.
Структура данных
Навык работает с несколькими типами данных:
- Погода — текущие условия и прогноз
- POI — поиск мест по ключевым словам
- Маршруты — расчёт маршрутов между координатами
- Геокодирование — адрес → координаты
- Административные данные — регионы и их коды
Примеры использования API
1. Запрос текущей погоды:
curl "https://restapi.amap.com/v3/weather/weatherInfo?key=$AMAP_KEY&city=[adcode]&extensions=base"2. Прогноз погоды:
curl "https://restapi.amap.com/v3/weather/weatherInfo?key=$AMAP_KEY&city=[adcode]&extensions=all"3. Поиск мест (POI):
curl "https://restapi.amap.com/v3/place/text?key=$AMAP_KEY&keywords=[ключевое слово]&city=[город]"4. Построение маршрута:
curl "https://restapi.amap.com/v3/direction/driving?key=$AMAP_KEY&origin=[координаты]&destination=[координаты]"5. Геокодирование (адрес → координаты):
curl "https://restapi.amap.com/v3/geocode/geo?key=$AMAP_KEY&address=[адрес]"6. Обратное геокодирование (координаты → адрес):
curl "https://restapi.amap.com/v3/geocode/regeo?key=$AMAP_KEY&location=[координаты]"7. Административные регионы:
curl "https://restapi.amap.com/v3/config/district?key=$AMAP_KEY&keywords=[регион]&subdistrict=0"Расширенные возможности
- Поддержка многоуровневых административных структур
- Гибкие режимы погодных данных (краткие и расширенные)
- Преобразование координат между различными системами
- Высокопроизводительный поиск объектов с фильтрацией
Amap превращает AI-агента в инструмент, способный взаимодействовать с реальным миром, обеспечивая доступ к точной географической информации и аналитике в режиме реального времени. :
Файл из источника