Changelog #

0.4.0 (unreleased) #

Routes API: new RoutesApi client (v2) with computeRoutes (alternatives, route modifiers: avoid tolls/highways/ferries; advanced waypoints: sideOfRoad + via/stopover; toll info; polyline quality; units/language; configurable X-Goog-FieldMask) and computeRouteMatrix (batch ETAs for multiple origins/destinations).
Navigation events: NavigationSession now exposes onState (navigating/offRoute/rerouting), onInstruction (step text + maneuver + distance), onProgress (distance remaining + ETA), and onSpeedAlert (simple speed monitor with optional static limit). TTS now supports rate/pitch/voice.
Camera helpers: NavigationSession.recenter()/overview() utilities. Follow-me remains with tilt/bearing smoothing via animateCamera.
Docs: README updated with Routes API usage, event streams, and notes for FlutterFlow actions.

PT-BR

Routes API: novo cliente RoutesApi (v2) com computeRoutes (alternativas, modificadores de rota: evitar pedágios/rodovias/balsas; waypoints avançados: sideOfRoad + via/stopover; info de pedágio; qualidade da polyline; unidades/idioma; X-Goog-FieldMask configurável) e computeRouteMatrix (ETAs em lote para múltiplas origens/destinos).
Eventos de navegação: NavigationSession expõe onState (navigating/offRoute/rerouting), onInstruction (texto + manobra + distância), onProgress (distância restante + ETA) e onSpeedAlert (velocímetro simples com limite estático opcional). TTS com rate/pitch/voice.
Câmera: utilitários recenter()/overview(). Follow-me segue com tilt/bearing suave via animateCamera.
Docs: README atualizado com uso do Routes API, event streams e dicas para FlutterFlow.

Android: MapView receives full host lifecycle (start/resume/pause/stop/destroy). Map is revealed only after OnMapLoadedCallback; emits event#onMapLoaded (exposed in Dart as onMapLoaded).
iOS: Reveal map only after content is ready (snapshotReady), also emits event#onMapLoaded.
iOS: Update polyline in place by changing GMSPolyline.path (no recreation). New channel method polylines#updatePoints.
Android: Update polyline points in place via Polyline.setPoints(...). New channel method polylines#updatePoints.
Dart API: Added updatePolylinePoints(String id, List<LatLng>) and onMapLoaded future in GoogleMapController.
Markers: URL icons decoded off-main-thread and resized to ~48dp; default anchor is now (u=0.5, v=0.62).
Static map: Added StaticMapView (Google Static Maps) with optional polyline, useful for Windows/desktop fallback.
Docs: README expanded with examples (onMapLoaded, updatePolylinePoints, static map, and best practices for high-frequency polyline updates – "snake": decimation + 16–32ms throttle without remove/add each frame).

PT-BR (ASCII)

Android: MapView agora recebe todos os lifecycles do host. Mapa aparece somente apos OnMapLoadedCallback; emite event#onMapLoaded (Dart: onMapLoaded).
iOS: Revela o mapa apenas quando pronto (snapshotReady), tambem emite event#onMapLoaded.
iOS: Atualiza GMSPolyline.path sem recriar. Novo metodo polylines#updatePoints.
Android: Atualiza pontos da polyline em lugar (Polyline.setPoints). Novo metodo polylines#updatePoints.
Dart: updatePolylinePoints(String id, List<LatLng>) e onMapLoaded no GoogleMapController.
Markers: icones por URL decodificados fora da main-thread e redimensionados (~48dp). Ancora padrao agora (0.5, 0.62).
Mapa estatico: novo StaticMapView com polyline (Google Static Maps), util no Windows/desktop.
Docs: README ampliado com exemplos e dicas de "snake" (decimacao + throttle 16–32ms, sem remover/adicionar a cada frame).

Navigation (Directions + Voice + Follow): new Dart helper with MapNavigator.start(...) and NavigationOptions to fetch a Google Directions route, draw the polyline, follow the user with the camera, and speak step instructions (TTS). Includes simple re-route when off-route.
Camera: new animateCamera(target, {zoom, tilt, bearing, durationMs}) method in GoogleMapController (native Android/iOS updated).
Docs: README updated with navigation usage.
Dependencies: added http, geolocator, flutter_tts (the app remains responsible for location permissions).

PT-BR

Navegação (Rotas + Voz + Follow): novo helper em Dart com MapNavigator.start(...) e NavigationOptions para buscar rota (Google Directions), desenhar a polyline, seguir a localização do usuário com a câmera e falar as instruções (TTS). Inclui re-roteamento simples ao sair da rota.
Câmera: novo método animateCamera(target, {zoom, tilt, bearing, durationMs}) no GoogleMapController (Android/iOS nativos atualizados).
Docs: README atualizado com uso de navegação.
Dependências: adicionadas http, geolocator, flutter_tts (o app continua responsável por permissões de localização).

First release of the plugin.
GoogleMapView widget with AndroidView / UiKitView.
GoogleMapController with: markers (add/update/remove/clear), polylines (add/remove/clear), camera (move/fit bounds), map style, traffic, myLocation, padding, snapshot.
Icon cache: LRU (Android) and NSCache (iOS) with async download.
Functional example (example/) simulating a ride flow (pickup/dropoff/route/driver).

PT-BR

Primeira versão do plugin.
Widget GoogleMapView com AndroidView/UiKitView.
GoogleMapController com: markers (add/update/remove/clear), polylines (add/remove/clear), câmera (move/fit bounds), estilo de mapa, tráfego, myLocation, padding, snapshot.
Cache de ícones: LRU (Android) e NSCache (iOS), com download assíncrono.
Exemplo funcional (example/) simulando fluxo de corrida (pickup/dropoff/rota/driver).