$ show maximn/google-maps
This is a .NET client library for Google Maps Platform web services. It provides a strongly-typed, async-first wrapper around 15+ Google Maps APIs, including Geocoding, Directions, Distance Matrix, Places (New), Routes, Address Validation, Elevation, Time Zone, Roads, Solar, Aerial View, Air Quality, Pollen, and Static Maps. The library is published as a NuGet package (over 2M downloads) and targets multiple .NET frameworks (netstandard2.0, net8.0, net10.0). It follows a consistent request/response pattern with generic constraints for compile-time safety, and includes a built-in engine that handles HTTP serialization, API key injection, error handling, and OpenTelemetry diagnostics (tracing and metrics). An optional dependency injection extension package registers `IGoogleMapsClient` with `IHttpClientFactory`. The repository also contains a comprehensive test suite with a VCR (record/replay) system, benchmarks, mutation testing, and sample applications (Blazor, Console, Minimal API, Generic Host) demonstrating usage.
The LLM identified 4 files worth highlighting for reuse:
Formats latitude/longitude values as strings without scientific notation, ensuring they can be safely used in query strings. This is a small but reusable utility that solves a common problem when serializing geographic coordinates to text.
A fluent builder for constructing Google Static Maps style parameters. Provides a chainable API for setting feature types, element types, visibility, hue, saturation, lightness, and gamma. Demonstrates a well-structured builder pattern that can be extracted and reused for any hierarchical configuration DSL.
An HTTP message handler that records and replays API interactions for deterministic integration testing. Supports modes (Record, Replay, Auto, Live) and integrates with cassette files stored as JSON. This is a reusable test harness that can be applied to any HTTP client testing scenario, not just Google Maps APIs.
A generic `System.Text.Json` converter that serializes enums using their `[EnumMember]` (or `[Description]`) attribute values. Handles both JSON serialization and deserialization. This is a reusable component for any project that needs custom enum serialization without reflection-heavy approaches.