becomap 2.0.0

A Flutter package for integrating Becomap interactive maps into Flutter applications. Requires authorization from Beco. Maintained by Globeco Technologies.

2.0.0

🎯 Major New Features

• NEW: focusTo() method for simplified location focusing with intelligent zoom defaults
  • Smart zoom levels based on location type (Tenant: 19.0, Parking: 16.0, Entrance: 18.0, etc.)
  • Optional custom zoom, bearing, and pitch parameters
  • Dramatically improved developer experience over manual setViewport() usage
  • Comprehensive validation and error handling
• NEW: getSite() method added to public BCMapViewState interface
• NEW: getCurrentFloor() method added to public BCMapViewState interface

🚀 Enhanced Developer Experience

• IMPROVED: Location-centric API design prioritizing common use cases
• IMPROVED: Simplified location focusing from 8+ lines of code to 1 line
• IMPROVED: Intelligent defaults reduce boilerplate code significantly
• IMPROVED: Better error messages and validation for location operations

📚 Documentation Overhaul

• FIXED: All documentation examples now use correct method names and constructors
• UPDATED: Comprehensive focusTo() documentation with usage examples
• UPDATED: API reference with complete method signatures and parameters
• UPDATED: Location interaction examples across all documentation files
• REMOVED: Outdated "not yet implemented" comments and incorrect method references

🔧 Technical Improvements

• ENHANCED: JavaScript bridge communication with detailed command logging
• ENHANCED: MapController with smart zoom calculation based on location types
• ENHANCED: Comprehensive unit test coverage for new functionality
• ENHANCED: Better separation of concerns in widget architecture

🐛 Bug Fixes

• FIXED: Documentation inconsistencies with actual SDK implementation
• FIXED: Method name mismatches between documentation and code
• FIXED: Constructor parameter issues in documentation examples

1.1.0

🚀 Enhanced BCMapView Widget

• NEW: Advanced controller interface BCMapViewState for programmatic map control via GlobalKey<BCMapViewState>
• NEW: Comprehensive controller methods for map interaction:
  • initialiseMap() - Map initialization with authentication and site configuration
  • selectFloor() - Floor switching and navigation
  • setViewport() - Camera positioning and zoom control
  • searchLocation() / searchCategory() - Search functionality with results
  • selectLocation() - Programmatic location selection
  • getRoute() / showRoute() / showStep() - Navigation and routing capabilities
  • clearRoute() / clearSelection() - State management and cleanup
• NEW: Enhanced callback system with detailed event information
• IMPROVED: Better widget architecture with clean separation of concerns

📊 Enhanced Data Models

• NEW: Comprehensive data model interfaces for all map entities
• NEW: Configuration models: BCMapInitOptions, BCMapSiteOptions, BCRouteOptions
• NEW: Navigation models: BCRouteSegment, BCRouteStep with detailed step information
• IMPROVED: Better type safety and validation for all data structures
• IMPROVED: Enhanced model documentation with usage examples

🔧 Developer Experience

• NEW: Enhanced error handling with specific error types and detailed messages
• NEW: Improved callback signatures with proper typing and documentation
• IMPROVED: Better API design following Flutter ecosystem best practices
• IMPROVED: Cleaner public API surface with consistent naming conventions

1.0.1

• Updated repository URL to https://github.com/iBeCo/becomap-flutter
• Improved README documentation with cleaner formatting
• Removed redundant platform support and dependencies sections

1.0.0

• BREAKING CHANGE: Package renamed from becomap_flutter_sdk to becomap for shorter, more concise naming
• Initial release of Becomap Flutter SDK
• Added BCMapView widget for displaying Becomap interactive maps
• WebView-based implementation with error handling and loading states
• Support for custom URLs and debug mode
• Cross-platform support for all Flutter platforms