Gravity.GoogleMaps.StaticMapBuilder 3.0.0

🌍 Gravity.GoogleMaps.StaticMapBuilder

Gravity.GoogleMaps.StaticMapBuilder is a fully type-safe, fluent, and extensible .NET URL builder for the Google Static Maps API. It helps you generate valid, optimized static map URLs effortlessly — with full IntelliSense, compile-time checks, and support for complex features like styles, markers, paths, map IDs, and more.

🚀 Features

• ✅ Fully type-safe and fluent API
• 🧠 Smart validation for all query parameters
• 🎨 Full support for styles, map types, and custom markers
• 🧭 Handles edge cases (map ID conflicts, marker limits, etc.)
• 🔐 Built with test coverage in mind (96%+)
• 🧪 Easy to unit test and extend

📦 Installation

dotnet add package Gravity.GoogleMaps.StaticMapBuilder

📚 Documentation

Explore detailed usage guides for key features:

• Markers → Standalone vs grouped markers, icons, limits, examples
• Map Styles → Hue, lightness, feature types
• Paths → Lines, polylines, geodesic options

🧭 See the official Google Maps Static API for complete reference.

⚡ Quick Start

var url = new StaticMapsUrlBuilder()
    .AddCenterWithCoordinates(48.8566, 2.3522)
    .AddZoom(13)
    .AddSize(600, 400)
    .AddMarkers(
        new LocationMarker("Eiffel Tower", label: 'E'),
        new CoordinatesMarker(48.8584, 2.2945, label: 'T')
    )
    .AddMapStyle(
        new MapStyle(
            new StyleRule(Color: new HexColor("0xFF0000")),
            Features.Road.AllRoad,
            Elements.Geometry.AllGeometry
        )
    )
    .AddKey("YOUR_API_KEY")
    .Build();

Please note that the url is not signed, see the official Google documentation for details.

🧱 Fluent Builders

Every parameter of the API is covered through intuitive, self-documenting builder methods:

.AddCenterWithLocation("Paris")
.AddZoom(12)
.AddScale(MapScale.Two)
.AddMapType(StaticMapType.Terrain)
.AddLanguage("en")

🎨 Custom Styles Made Simple

var style = new MapStyle(
    new StyleRule(Hue: new HexColor("0x00FF00"), Visibility: Visibility.Simplified),
    Features.Administrative.Country,
    Elements.Labels.Text.AllText
);

📍 Marker Groups and Icons

var group = new MarkerGroup(MarkerSize.Mid, iconUrl: "http://yourcdn.com/marker.png");
group.AddLocation("Lyon");
group.AddCoordinates(45.75, 4.85);

🧪 Test Coverage & Reliability

• 95%+ code coverage
• Every builder method has unit and integration tests
• Constraints validated both at build-time and runtime

🛡️ License

MIT License

🙌 Credits

Made with ❤️ by GravityApps Developed & maintained by freelance developer https://github.com/AntoninLolivier

Want to contribute or suggest an improvement? 👉 Open an issue or pull request on GitHub