Skip to content

Migrate from Ambee to Google Pollen API#1

Merged
pburtchaell merged 1 commit intomainfrom
google-pollen-api
Feb 17, 2026
Merged

Migrate from Ambee to Google Pollen API#1
pburtchaell merged 1 commit intomainfrom
google-pollen-api

Conversation

@pburtchaell
Copy link
Copy Markdown
Owner

Ambee discontinued their free API tier. This replaces the Ambee integration with the Google Pollen API, which provides tree/grass/weed data on a 0-5 Universal Pollen Index with 5,000 free requests/month.

  • Replace Ambee API client with Google Pollen API (query param auth, UPI index parsing, 403 handling for billing/enablement errors)
  • Add Nominatim geocoding service to resolve location strings to lat/lng with file-based caching in Homebridge storage
  • Simplify AirQuality mapping (UPI 0-5 maps directly to HomeKit enum)
  • Add vitest with 19 tests covering API parsing, error handling, caching, backoff, geocoding, and UPI mapping
  • Align dev tooling with homebridge-seasons: ESLint flat config with shared rules, husky pre-commit (lint + test), GitHub CI workflow with Node 20.x/22.x matrix, nodemon with test/homebridge config
  • Bump to 2.0.0-beta.0 (breaking: requires Google Maps API key)

Ambee discontinued their free API tier. This replaces the Ambee
integration with the Google Pollen API, which provides tree/grass/weed
data on a 0-5 Universal Pollen Index with 5,000 free requests/month.

- Replace Ambee API client with Google Pollen API (query param auth,
  UPI index parsing, 403 handling for billing/enablement errors)
- Add Nominatim geocoding service to resolve location strings to
  lat/lng with file-based caching in Homebridge storage
- Simplify AirQuality mapping (UPI 0-5 maps directly to HomeKit enum)
- Add vitest with 19 tests covering API parsing, error handling,
  caching, backoff, geocoding, and UPI mapping
- Align dev tooling with homebridge-seasons: ESLint flat config with
  shared rules, husky pre-commit (lint + test), GitHub CI workflow
  with Node 20.x/22.x matrix, nodemon with test/homebridge config
- Bump to 2.0.0-beta.0 (breaking: requires Google Maps API key)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@pburtchaell pburtchaell merged commit 5f2e644 into main Feb 17, 2026
4 checks passed
@pburtchaell pburtchaell deleted the google-pollen-api branch February 17, 2026 06:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant