Filament Yandex Map Laravel Package

Product Decisions This Supports

• Geospatial Data Collection: Enables seamless integration of Yandex Maps into Filament admin panels for location-based data entry (e.g. real estate listings, delivery addresses, field service tracking).
• Area-Based Data Modeling: The new multipolygon mode (v5.1.0) unlocks zone, boundary, and region-based use cases—delivery coverage areas, service territories, property plots—not just single-point pinning.
• User Experience (UX) Enhancement: Reduces friction in forms by replacing manual coordinates with an interactive map, improving data accuracy and user satisfaction.
• Roadmap for Localization: Supports multilingual map interfaces (via lang config) to align with global or region-specific products (e.g. Russian-speaking markets).
• Build vs. Buy: Avoids reinventing a custom map solution for Filament, leveraging Yandex's mature API and this package's abstraction layer.
• Compliance & Data Privacy: Aligns with regional data residency requirements (e.g. Yandex Maps may be preferred over Google Maps in jurisdictions like Russia or CIS countries).

When to Consider This Package

• Adopt if:

  • Your product requires geospatial data input in a Filament admin panel.
  • You need point or area (polygon/multipolygon) capture—e.g. coverage zones or service territories.
  • You're already using Laravel Filament and need a low-code map integration.
  • Your target audience is in Russia/CIS regions (Yandex Maps is dominant there).
  • You prioritize simplicity over advanced map features (e.g. no need for real-time routing or custom overlays).
  • Your team lacks frontend expertise to build a custom map solution.

• Look elsewhere if:

  • You need Google Maps or another provider (e.g. Mapbox, OpenStreetMap).
  • Your use case requires real-time tracking, heatmaps, or custom overlay/routing logic (polygon editing is now supported, but full GIS workflows are not).
  • You're targeting non-Russian markets where Yandex Maps has limited adoption.
  • Your project already uses a different admin panel framework (e.g. Nova, Backpack).
  • You need offline capabilities or highly customized map behaviors.

How to Pitch It (Stakeholders)

For Executives: "This package lets us integrate Yandex Maps directly into our Filament admin panels with minimal dev effort. It's ideal for location-based features—property listings, service dispatch, and now coverage-area or territory definition via polygons—and aligns with regional preferences in Russia/CIS. By reducing manual coordinate entry errors and improving UX, we accelerate time-to-market for geospatial products while keeping costs low. The MIT license and active maintenance make it a low-risk choice."

For Engineering: *"This is a lightweight, well-structured wrapper for Yandex Maps in Filament. Key benefits:

• Zero frontend work: Plugs into Filament forms via a simple YandexMap component.
• Config-driven: Override defaults (API keys, center, zoom) via Laravel config or closures.
• Localization-ready: Supports multiple languages out of the box.
• Broadened geometry support: v5.1.0 adds multipolygon mode, expanding beyond single pointmarks/clusters to area-based data capture, and ships with tests for state handlers plus a PolygonRule translation fix—improving reliability.
• Maintained: Active releases (v5.1.0, 2025), MIT license, new contributors onboarding. Tradeoff: Point/marker and polygon/multipolygon geometry cover most CRUD needs, but complex GIS workflows (real-time tracking, custom overlays, routing) remain out of scope. Recommended for MVP or regional products where Yandex Maps is the standard."*