google_map_service 0.0.1

A Flutter package that provides a complete service layer for Google Maps, including APIs for map initialization, markers, geocoding, directions, places, and distance calculations — all in a clean, eas [...]

🗺️ Google Map Service for Flutter

A complete Flutter package that wraps and simplifies Google Maps APIs into a clean, service-based architecture.
It provides easy-to-use methods for map interactions, directions, geocoding, places, and distance calculations — all using the official Google Maps Platform.

---

🚀 Features

• 🧭 Map Initialization – Effortlessly display and control Google Maps widgets.
• 📍 Markers & Polylines Management – Add, update, and remove markers and polylines dynamically.
• 🗺️ Geocoding / Reverse Geocoding – Convert between coordinates and addresses.
• 🧠 Places API Integration – Search, autocomplete, and get detailed place info.
• 🛣️ Directions API – Get routes, distances, and durations between two or more locations.
• 📏 Distance Matrix API – Calculate travel distance and time for multiple origins/destinations.
• 🌍 Custom Map Styles – Apply dark/light/custom themes easily.
• ⚡ Async, Null-safe, and Well-structured – Built for modern Flutter and Dart.

---

📦 Installation

Add the dependency to your pubspec.yaml:

dependencies:
  google_map_service: ^0.0.1

Then run:

flutter pub get

---

🔑 Setup

1. Enable Google APIs

   Make sure the following APIs are enabled on your Google Cloud Console:

   • Maps SDK for Android
   • Maps SDK for iOS
   • Geocoding API
   • Places API
   • Directions API
   • Distance Matrix API

2. Add your API key

   In your AndroidManifest.xml:

   <meta-data
       android:name="com.google.android.geo.API_KEY"
       android:value="YOUR_API_KEY_HERE" />
   

   In your AppDelegate.swift (iOS):

   GMSServices.provideAPIKey("YOUR_API_KEY_HERE")
   

3. Initialize the service

   import 'package:google_map_service/google_map_service.dart';
   
   final mapService = GoogleMapService(apiKey: 'YOUR_API_KEY_HERE');
   

---

🧩 API Usage

🗺️ Displaying a Google Map

GoogleMap(
  initialCameraPosition: CameraPosition(
    target: LatLng(37.7749, -122.4194),
    zoom: 12,
  ),
  onMapCreated: mapService.onMapCreated,
  markers: mapService.markers,
  polylines: mapService.polylines,
);

---

📍 Add a Marker

mapService.addMarker(
  id: 'marker1',
  position: LatLng(37.7749, -122.4194),
  title: 'San Francisco',
  snippet: 'California',
);

---

🧭 Get Directions

final route = await mapService.getDirections(
  origin: LatLng(37.7749, -122.4194),
  destination: LatLng(34.0522, -118.2437),
);

mapService.addPolylineFromDirections(route);

---

🌍 Geocode an Address

final coordinates = await mapService.geocodeAddress('1600 Amphitheatre Parkway, Mountain View, CA');

📫 Reverse Geocode a Coordinate

final address = await mapService.reverseGeocode(LatLng(37.4219999, -122.0840575));

---

🧠 Place Autocomplete

final results = await mapService.autocompletePlaces('Eiffel Tower');

---

⚙️ Configuration Options

GoogleMapService(
  apiKey: 'YOUR_API_KEY',
  language: 'en',
  region: 'US',
  mapStyle: MapStyle.dark,
);

---

📘 Example App

See /example folder for a complete Flutter demo using all APIs.

Run:

flutter run example/

---

🧪 Testing

Mock services are included for unit testing.

final mockService = MockGoogleMapService();

---

🔐 Permissions

Add these permissions in your AndroidManifest.xml and Info.plist:

• Android:

  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  

• iOS:

  <key>NSLocationWhenInUseUsageDescription</key>
  <string>This app needs access to your location.</string>
  

---

🧰 Supported Platforms

• ✅ Android
• ✅ iOS
• ✅ Web (limited APIs – requires JS Maps SDK)

---

📄 License

This project is licensed under the MIT License – see the LICENSE file for details.

---

💡 Contributing

Pull requests are welcome!
Please make sure to:

• Write clear commit messages.
• Add documentation and test coverage for new features.

---

🏁 Roadmap

• ❌ Support for custom map overlays
• ❌ Offline maps support
• ❌ Route optimization
• ❌ Street View integration

---

👨‍💻 Author

Raj kumar Patel
Flutter Developer | Open Source Contributor
📧 [e-mail]