Google Places Native SDK 🌍 #

A powerful, high-performance Flutter plugin that integrates Google Places SDK directly with native APIs for Android and iOS. Build beautiful, location-aware applications with real-time prediction and detailed place information.

📱 Version Compatibility #

✨ Features #

🚀 Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  google_places_native_sdk: ^3.0.0

Or run:

flutter pub add google_places_native_sdk

⚙️ Configuration #

To use this plugin, you need to configure your Google Maps/Places API keys in your native project files.

Important: Ensure you have enabled the following APIs in your Google Cloud Console:

• Maps SDK for Android
• Maps SDK for iOS
• Places API (New)

🤖 Android #

1. Open android/app/src/main/AndroidManifest.xml.
2. Add your API key inside the <application> tag:

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

Security Recommendation:

• Restrict your Android API key in the Google Cloud Console.
• Application restriction: Android apps (Use your package name and SHA-1 certificate fingerprint).
• API restriction: Select ONLY Maps SDK for Android and Places API (New).

🍎 iOS #

1. Open ios/Runner/AppDelegate.swift.
2. Import GoogleMaps and provide your API key:

import GoogleMaps

GMSServices.provideAPIKey("YOUR_API_KEY_IOS")

Security Recommendation:

• Restrict your iOS API key in the Google Cloud Console.
• Application restriction: iOS apps (Use your app's Bundle Identifier).
• API restriction: Select ONLY Maps SDK for iOS and Places API (New).

💡 How to Use #

Quick Start: Initialize the SDK with your API key and start making requests!

import 'package:google_places_native_sdk/google_places_native_sdk.dart';
import 'dart:io' show Platform;

void main() async {
  // 1. Initialize the SDK
  // It is recommended to use different API keys for Android and iOS
  String apiKey = Platform.isAndroid 
      ? 'YOUR_API_KEY_ANDROID' 
      : 'YOUR_API_KEY_IOS';
      
  await PlacesChannel.initialize(apiKey);
  
  // 2. Search for places
  try {
    final predictions = await PlacesChannel.getAutocompletePredictions("Paris");
    print("Found ${predictions.length} results");
  } catch (e) {
    print("Error: $e");
  }
}

🔍 Detailed Usage Examples #

Search for a Place (Autocomplete)

Get real-time predictions as the user types.

final predictions = await PlacesChannel.getAutocompletePredictions("San Fran");

for (var p in predictions) {
  print("${p.primaryText} - ${p.placeId}");
}

Get Place Details

Fetch coordinates and address for a selected place.

final details = await PlacesChannel.getPlaceDetails("ChIJIQBpAG2ahYAR_6128GcTUEo");

print("Selected: ${details.name}");
print("Location: ${details.latitude}, ${details.longitude}");

📱 Example App #

Check out the example/ folder for a complete Demo Application that features:

• Glassmorphic Search UI
• Google Maps Integration
• Live Location Tracking
• Custom Markers

🤝 Contributing #

Contributions are welcome! If you find a bug or want a feature, please open an issue.

📄 License #

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