google_maps_native_sdk 0.5.0

Native Google Maps plugin for Flutter/FlutterFlow with markers, polylines, caching, events — ideal for mobility apps (e.g., taxi).

Changelog

0.4.4

EN

• 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.
• Sample: new example/lib/routes_tbt_demo.dart (Routes + TBT). Android Auto reference at example/android-auto-sample/.

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.
• Sample: example/lib/routes_tbt_demo.dart (Rotas + TBT). Exemplo de referência Android Auto em example/android-auto-sample/.

0.4.0

EN

• 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.

0.3.0

EN

• 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).

0.2.0

EN

• 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).

0.1.0

EN

• 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).

0.5.0

EN

• Web: interactive map for Flutter Web using Google Maps JavaScript API, loaded dynamically (optional manual script). Supports markers, polylines (update in place), camera controls, style (JSON tint), traffic layer, and events (marker tap, map loaded). Caching via browser (tiles/icons) and in-memory reuse by ids.
• API: GoogleMapView adds webApiKey (optional) to auto-load JS. Controller adapts transparently on Web.
• Docs: README expanded with Web setup and code sample. No change required in native platforms.

PT-BR

• Web: mapa interativo no Flutter Web usando a Google Maps JavaScript API (carregamento dinâmico; ou script manual). Suporte a markers, polylines (atualização in-place), câmera, estilo (JSON/tint), camada de tráfego e eventos (toque em marker, mapa pronto). Cache via navegador (tiles/ícones) e reuso em memória por ids.
• API: GoogleMapView ganhou webApiKey (opcional) para carregar a JS API automaticamente. Controller funciona de forma transparente no Web.
• Docs: README com guia de Web e exemplo de código. Nenhuma mudança no Android/iOS.