google_maps_native_sdk 0.2.0

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

Google Maps Native SDK (Flutter/FlutterFlow)

• Native Google Maps plugin (Android Java / iOS Swift) for Flutter, built for mobility apps (e.g., taxi): markers, polylines, events, snapshot and icon caching. Bilingual docs (English/Português) below.

Features

• Native PlatformView (AndroidView / UiKitView).
• Markers with icon by URL (memory + disk cache), anchor, rotation and z-index.
• Polylines (points list or encoded polyline via addPolylineFromEncoded).
• Camera: move/animate, fit bounds with padding.
• Map styling: JSON style or single-color tint via setMapColor(Color, {dark: false}).
• Extras: traffic, buildings, map padding, snapshot.
• Events: marker tap (onMarkerTap stream).

Navigation (Directions + Voice + Follow)

• New: lightweight turn-by-turn helper in Dart. Fetches a Google Directions route, draws the polyline, follows the user's location with camera, and speaks upcoming step instructions.
• API:
  • MapNavigator.start(controller: ..., options: NavigationOptions(...)) → returns a NavigationSession (call stop() to end).
  • NavigationOptions requires a Google Directions API key, origin, destination; supports mode, language (default pt-BR), voiceGuidance, cameraZoom, cameraTilt, followBearing, voiceAheadDistanceMeters, and simple off-route re-route.
• Camera: added animateCamera(target, {zoom, tilt, bearing, durationMs}) to smoothly follow the user.
• Dependencies: http, geolocator, flutter_tts (already included in this package). Your app must handle location permissions.

Usage (simplified):

final session = await MapNavigator.start(
  controller: controller,
  options: NavigationOptions(
    apiKey: 'YOUR_DIRECTIONS_API_KEY',
    origin: LatLng(-23.561, -46.656),
    destination: LatLng(-23.570, -46.650),
    language: 'pt-BR',
    voiceGuidance: true,
  ),
);
// Later: await session.stop();

Install

• Add dependency in your app pubspec.yaml (path/git or Pub when published).
• Android: add your Google Maps API Key in the app AndroidManifest.xml:
  • <meta-data android:name="com.google.android.geo.API_KEY" android:value="YOUR_API_KEY"/>
• iOS: provide the API key in AppDelegate or Info.plist:
  • GMSServices.provideAPIKey("YOUR_API_KEY") or GMSApiKey in Info.plist.

Quick Start (see example/lib/main.dart)

• Widget: GoogleMapView(initialCameraPosition: CameraPosition(target: LatLng(-23.56,-46.65), zoom: 13), onMapCreated: ...).
• Controller: addMarker(...), addPolyline(...), moveCamera(...), animateToBounds(...), setMapStyle(...), setMapColor(...), takeSnapshot().

FlutterFlow

• Import as Custom Package and use GoogleMapView. Use onMapCreated to wire controller calls via custom actions.

Best practices (mobility/taxi)

• Enable trafficEnabled when useful to reduce visual noise.
• Use setPadding to accommodate panels (e.g., bottom sheet).
• Update driver position with updateMarker (optionally smooth in Dart first).
• Use URL marker icons; built-in memory+disk cache reduces flicker and network.

Notes / Limitations

• Location permissions are app responsibility (e.g., permission_handler).
• Clustering is not exposed yet (native Utils libs are included for future work).
• Full offline tiles are not supported; use SDK cache + custom tiles if needed.

—

Google Maps Native SDK (Flutter/FlutterFlow) — Português

• Plugin Flutter com views nativas (Android Java / iOS Swift) do Google Maps, focado em apps de mobilidade (ex.: táxi): markers, polylines, eventos, snapshot e cache de ícones (memória + disco). Documentação bilíngue.

Recursos

• PlatformView nativo (AndroidView / UiKitView).
• Markers com ícone por URL (cache memória + disco), âncora, rotação e z-index.
• Polylines (lista de pontos ou polyline codificado via addPolylineFromEncoded).
• Câmera: mover/animar, bounds com padding.
• Estilização: JSON ou cor única com setMapColor(Color, {dark: false}).
• Extras: tráfego, prédios, padding do mapa, snapshot.
• Eventos: toque em marker (onMarkerTap).

Navegação (Rotas + Voz + Follow)

• Novo: helper leve de navegação em Dart. Busca a rota no Google Directions, desenha a polyline, segue a localização do usuário com a câmera e fala a próxima instrução.
• API:
  • MapNavigator.start(controller: ..., options: NavigationOptions(...)) → retorna NavigationSession (use stop() para encerrar).
  • NavigationOptions exige a Directions API Key, origin, destination; suporta mode, language (padrão pt-BR), voiceGuidance, cameraZoom, cameraTilt, followBearing, voiceAheadDistanceMeters e re-roteamento simples quando sai da rota.
• Câmera: adicionamos animateCamera(target, {zoom, tilt, bearing, durationMs}) para seguir o usuário suavemente.
• Dependências: http, geolocator, flutter_tts (já incluídas). Seu app deve pedir permissões de localização.

Exemplo:

final session = await MapNavigator.start(
  controller: controller,
  options: NavigationOptions(
    apiKey: 'SUA_DIRECTIONS_API_KEY',
    origin: LatLng(-23.561, -46.656),
    destination: LatLng(-23.570, -46.650),
    language: 'pt-BR',
    voiceGuidance: true,
  ),
);
// Depois: await session.stop();

Instalação

• Adicione no pubspec.yaml do app (path/git ou Pub quando publicado).
• Android: adicione a API Key no AndroidManifest.xml do app.
• iOS: forneça a API Key no AppDelegate ou Info.plist.

Uso Rápido

• Widget e controller conforme exemplo em example/lib/main.dart.
• Chaves principais: addMarker, addPolyline, moveCamera, animateToBounds, setMapStyle, setMapColor, takeSnapshot.

FlutterFlow

• Importe como Custom Package e use GoogleMapView com onMapCreated para acionar o controller por ações custom.

Boas práticas

• Habilite trafficEnabled quando útil.
• Use setPadding para acomodar overlays.
• Atualize posição do motorista com updateMarker.
• Ícones por URL com cache (memória + disco) integrado.

Limitações

• Permissões de localização são do app.
• Clustering: previsto para próxima versão.