Local Places

Local Places — это навык для поиска мест (рестораны, кафе и другие заведения) через прокси Google Places API, работающий локально.

Обзор

Навык позволяет быстро находить заведения поблизости, используя локальный сервер и API Google Places. Основной сценарий — сначала определить локацию, а затем выполнить поиск по заданным параметрам.

Установка

clawhub install local-places

После установки необходимо задать API-ключ Google Places в переменной окружения:

GOOGLE_PLACES_API_KEY=your-key

Далее запустите локальный сервер:

uvicorn local_places.main:app --host 127.0.0.1 --port 8000

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

Проверка сервера:

curl http://127.0.0.1:8000/ping

Определение локации:

curl -X POST http://127.0.0.1:8000/locations/resolve \
-H "Content-Type: application/json" \
-d '{"location_text": "Soho, London", "limit": 5}'

Поиск мест:

curl -X POST http://127.0.0.1:8000/places/search \
-H "Content-Type: application/json" \
-d '{
 "query": "coffee shop",
 "location_bias": {"lat": 51.5137, "lng": -0.1366, "radius_m": 1000},
 "filters": {"open_now": true, "min_rating": 4.0},
 "limit": 10
}'

Как это работает

• Если пользователь указывает «рядом со мной» или нечеткую локацию — сначала выполняется её определение
• При нескольких вариантах — предлагается список для выбора
• Уточняются предпочтения: тип заведения, рейтинг, открыто ли сейчас
• Выполняется поиск с учетом географического смещения
• Результаты выводятся с ключевой информацией
• Можно запросить детали или уточнить поиск

Фильтры

• types — один тип (например, restaurant, cafe)
• price_levels — от 0 до 4
• min_rating — от 0 до 5
• open_now — открыт ли сейчас
• limit — количество результатов

Формат ответа

{
 "results": [
 {
 "place_id": "ChIJ...",
 "name": "Coffee Shop",
 "address": "123 Main St",
 "location": {"lat": 51.5, "lng": -0.1},
 "rating": 4.6,
 "price_level": 2,
 "types": ["cafe", "food"],
 "open_now": true
 }
 ],
 "next_page_token": "..."
}

Для получения дополнительных результатов используйте next_page_token в следующем запросе.

Итог

Local Places — это простой и быстрый способ добавить поиск заведений в локальную инфраструктуру агента. Он сочетает гибкость фильтрации, понятный workflow и возможность точной работы с геолокацией.