Flutter प्रोजेक्ट सेट अप करें

Flutter प्रोजेक्ट सेट अप करने से पहले, पक्का करें कि आपने शुरू करने से पहले में बताए गए ज़रूरी चरणों को पूरा कर लिया हो. बिलिंग की सुविधा चालू करने और एपीआई पासकोड बनाने के बाद, वह Flutter प्रोजेक्ट सेट अप किया जा सकता है जिसका इस्तेमाल करके आपको ऐप्लिकेशन डेवलप करना है.

पहला चरण: ज़रूरी सॉफ़्टवेयर इंस्टॉल करना

Flutter के लिए Google Maps पैकेज का इस्तेमाल करके प्रोजेक्ट बनाने के लिए, आपको Flutter SDK टूल इंस्टॉल करना होगा. साथ ही, टारगेट किए गए प्लैटफ़ॉर्म के लिए डेवलपमेंट एनवायरमेंट सेट अप करना होगा. ज़्यादा जानकारी के लिए, Flutter इंस्टॉल करने से जुड़ी गाइड देखें.

दूसरा चरण: किसी नए प्रोजेक्ट में Google Maps for Flutter पैकेज इंस्टॉल करना

Flutter, Google Maps for Flutter पैकेज को Flutter प्लगिन के तौर पर उपलब्ध कराता है.

Flutter प्रोजेक्ट बनाएं और Maps प्लग इन जोड़ें.

  1. `flutter create` का इस्तेमाल करके नया Flutter प्रोजेक्ट बनाएं:
      flutter create google_maps_in_flutter --platforms=android,ios,web
      
      Creating project google_maps_in_flutter...
      [Listing of created files elided]
      Wrote 127 files.
    
      All done!
    आपका आवेदन कोड google_maps_in_flutter/lib/main.dart में है. अपना ऐप्लिकेशन चलाने के लिए, यह टाइप करें:
      cd google_maps_in_flutter
      flutter run
    यह ऐप्लिकेशन, iOS, Android, और वेब को टारगेट करता है. फ़िलहाल, Google Maps SDK टूल, ब्राउज़र के अलावा किसी अन्य डेस्कटॉप ऐप्लिकेशन के साथ काम नहीं करता.
  2. इस प्रोजेक्ट में, Google Maps for Flutter पैकेज प्लगिन जोड़ें.
    flutter pub add google_maps_flutter
      
      Resolving dependencies...
      [Listing of dependencies elided]
    
      Changed 14 dependencies!

तीसरा चरण: प्लैटफ़ॉर्म का वर्शन सेट करना

Android

Android के लिए, SDK टूल का कम से कम लेवल वाला वर्शन सेट करें.

  1. अपने पसंदीदा आईडीई में android/app/build.gradle कॉन्फ़िगरेशन फ़ाइल खोलें.
  2. android.defaultConfig.minSdkVersion की वैल्यू को 21 में बदलें:
      android {
        //...
        defaultConfig {
            applicationId "com.example.google_maps_in_flutter"
            minSdkVersion 21     // Set to 21
            targetSdkVersion flutter.targetSdkVersion
            versionCode flutterVersionCode.toInteger()
            versionName flutterVersionName
        }
        //...
      }
  3. defaultConfig को कॉन्फ़िगर करते समय, अपना यूनीक ApplicationID डालें.
  4. फ़ाइल सेव करें और अपने प्रोजेक्ट में किए गए बदलावों को Gradle के साथ सिंक करें.

iOS

iOS प्लैटफ़ॉर्म का कम से कम वर्शन सेट करें.

  1. अपने पसंदीदा आईडीई में ios/Podfile कॉन्फ़िगरेशन फ़ाइल खोलें.
  2. इस Podfile की शुरुआत में ये लाइनें जोड़ें:
      # Set platform to 14.0 to enable latest Google Maps SDK
      platform :ios, '14.0'

चौथा चरण: प्रोजेक्ट में अपनी एपीआई कुंजी जोड़ना

शुरू करने से पहले सेक्शन में, आपने अपने ऐप्लिकेशन के लिए एक एपीआई पासकोड जनरेट किया था. अब उस पासकोड को अपने Flutter प्रोजेक्ट में जोड़ें. Flutter के लिए, आपको यह एपीआई पासकोड, टारगेट किए गए सभी प्लैटफ़ॉर्म पर जोड़ना चाहिए: iOS, Android, और वेब.

यहां दिए गए उदाहरणों में, YOUR_API_KEY की जगह अपनी एपीआई कुंजी डालें.

Android

हमारा सुझाव है कि इस काम को आसान बनाने के लिए, आप Android के लिए Secrets Gradle प्लग इन का इस्तेमाल करें.

अपने Google Maps प्रोजेक्ट में, Android के लिए Secrets Gradle प्लग इन इंस्टॉल करने के लिए:

  1. Android Studio में, अपनी टॉप-लेवल build.gradle.kts या build.gradle फ़ाइल खोलें और buildscript में मौजूद dependencies एलिमेंट में यह कोड जोड़ें.

    Kotlin

    buildscript {
        dependencies {
            classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1")
        }
    }

    ग्रूवी

    buildscript {
        dependencies {
            classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1"
        }
    }
  2. मॉड्यूल-लेवल की build.gradle.kts या build.gradle फ़ाइल खोलें और plugins एलिमेंट में यह कोड जोड़ें.

    Kotlin

    plugins {
        // ...
        id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
    }

    ग्रूवी

    plugins {
        // ...
        id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
    }
  3. मॉड्यूल-लेवल की build.gradle.kts या build.gradle फ़ाइल में, पक्का करें कि targetSdk और compileSdk को 34 पर सेट किया गया हो.
  4. फ़ाइल सेव करें और अपने प्रोजेक्ट को Gradle के साथ सिंक करें.
  5. अपनी टॉप-लेवल डायरेक्ट्री में secrets.properties फ़ाइल खोलें. इसके बाद, यहां दिया गया कोड जोड़ें. YOUR_API_KEY को अपनी एपीआई पासकोड से बदलें. अपनी कुंजी को इस फ़ाइल में सेव करें, क्योंकि secrets.properties को वर्शन कंट्रोल सिस्टम में शामिल नहीं किया जाता.
    MAPS_API_KEY=YOUR_API_KEY
  6. फ़ाइल सेव करें.
  7. अपनी टॉप-लेवल डायरेक्ट्री में local.defaults.properties फ़ाइल बनाएं. यह फ़ाइल, secrets.properties फ़ाइल वाले फ़ोल्डर में होनी चाहिए. इसके बाद, नीचे दिया गया कोड जोड़ें.

    MAPS_API_KEY=DEFAULT_API_KEY

    इस फ़ाइल का मकसद, एपीआई पासकोड का बैकअप सेव करना है. ऐसा इसलिए किया जाता है, ताकि अगर secrets.properties फ़ाइल न मिले, तो भी बिल्ड न रुके. ऐसा तब हो सकता है, जब आपने ऐप्लिकेशन को किसी ऐसे वर्शन कंट्रोल सिस्टम से क्लोन किया हो जिसमें secrets.properties शामिल न हो और आपने एपीआई पासकोड देने के लिए, अब तक लोकल तौर पर secrets.properties फ़ाइल न बनाई हो.

  8. फ़ाइल सेव करें.
  9. अपनी AndroidManifest.xml फ़ाइल में, com.google.android.geo.API_KEY पर जाएं और android:value attribute को अपडेट करें. अगर <meta-data> टैग मौजूद नहीं है, तो इसे <application> टैग के चाइल्ड के तौर पर बनाएं.
    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="${MAPS_API_KEY}" />

    ध्यान दें: com.google.android.geo.API_KEY, एपीआई पासकोड के लिए सुझाया गया मेटाडेटा नाम है. इस नाम वाली कुंजी का इस्तेमाल, Android प्लैटफ़ॉर्म पर कई Google Maps-आधारित एपीआई की पुष्टि करने के लिए किया जा सकता है. इनमें Flutter SDK भी शामिल है. पुराने सिस्टम के साथ काम करने की सुविधा के लिए, एपीआई में com.google.android.maps.v2.API_KEY नाम भी काम करता है. इस लेगसी नाम का इस्तेमाल करके, सिर्फ़ Android Maps API v2 की पुष्टि की जा सकती है. कोई ऐप्लिकेशन, एपीआई पासकोड के मेटाडेटा के सिर्फ़ एक नाम का इस्तेमाल कर सकता है. अगर दोनों एट्रिब्यूट की वैल्यू दी गई है, तो एपीआई एक अपवाद दिखाता है.

  10. Android Studio में, अपने मॉड्यूल-लेवल की build.gradle.kts या build.gradle फ़ाइल खोलें और secrets प्रॉपर्टी में बदलाव करें. अगर secrets प्रॉपर्टी मौजूद नहीं है, तो उसे जोड़ें.

    propertiesFileName को secrets.properties पर सेट करने के लिए, प्लग इन की प्रॉपर्टी में बदलाव करें. साथ ही, defaultPropertiesFileName को local.defaults.properties पर सेट करें और कोई अन्य प्रॉपर्टी सेट करें.

    Kotlin

    secrets {
        // To add your Maps API key to this project:
        // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
        // 2. Add this line, where YOUR_API_KEY is your API key:
        //        MAPS_API_KEY=YOUR_API_KEY
        propertiesFileName = "secrets.properties"
    
        // A properties file containing default secret values. This file can be
        // checked in version control.
        defaultPropertiesFileName = "local.defaults.properties"
    
        // Configure which keys should be ignored by the plugin by providing regular expressions.
        // "sdk.dir" is ignored by default.
        ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
        ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
    }
            

    ग्रूवी

    secrets {
        // To add your Maps API key to this project:
        // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
        // 2. Add this line, where YOUR_API_KEY is your API key:
        //        MAPS_API_KEY=YOUR_API_KEY
        propertiesFileName = "secrets.properties"
    
        // A properties file containing default secret values. This file can be
        // checked in version control.
        defaultPropertiesFileName = "local.defaults.properties"
    
        // Configure which keys should be ignored by the plugin by providing regular expressions.
        // "sdk.dir" is ignored by default.
        ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
        ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
    }
            

ध्यान दें: जैसा कि ऊपर दिखाया गया है, एपीआई पासकोड के लिए, com.google.android.geo.API_KEY का सुझाया गया मेटाडेटा नाम है. इस नाम वाली कुंजी का इस्तेमाल, Android प्लैटफ़ॉर्म पर कई Google Maps-आधारित एपीआई की पुष्टि करने के लिए किया जा सकता है. इनमें Flutter SDK भी शामिल है. पुराने सिस्टम के साथ काम करने की सुविधा के लिए, एपीआई में com.google.android.maps.v2.API_KEY नाम भी काम करता है. इस लेगसी नाम का इस्तेमाल करके, सिर्फ़ Android Maps API v2 को ऑथेंटिकेट किया जा सकता है. कोई ऐप्लिकेशन, एपीआई पासकोड के मेटाडेटा के नामों में से सिर्फ़ एक का इस्तेमाल कर सकता है. अगर दोनों एट्रिब्यूट की वैल्यू दी गई है, तो एपीआई एक अपवाद दिखाता है.

iOS

अपनी AppDelegate.swift फ़ाइल में एपीआई पासकोड जोड़ें.

  1. अपने पसंदीदा IDE की मदद से, Flutter प्रोजेक्ट में ios/Runner/AppDelegate.swift फ़ाइल खोलें.
  2. अपने ऐप्लिकेशन में Google Maps for Flutter पैकेज जोड़ने के लिए, यह इंपोर्ट स्टेटमेंट जोड़ें:
  3. import GoogleMaps
  4. application(_:didFinishLaunchingWithOptions:) तरीके में अपना एपीआई जोड़ें. इसके लिए, YOUR_API_KEY के लिए अपनी एपीआई कुंजी का इस्तेमाल करें:
    GMSServices.provideAPIKey("YOUR_API_KEY")
  5. AppDelegate.swift फ़ाइल को सेव करके बंद करें.

पूरी की गई AppDelegate.swift फ़ाइल कुछ ऐसी दिखनी चाहिए:

import UIKit
import Flutter
import GoogleMaps  // Add this import

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    GeneratedPluginRegistrant.register(with: self)

    // TODO: Add your Google Maps API key
    GMSServices.provideAPIKey("YOUR_API_KEY")

    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
}

वेब

अपनी index.html ऐप्लिकेशन फ़ाइल में एपीआई पासकोड जोड़ें.

  1. अपने पसंदीदा IDE की मदद से, Flutter प्रोजेक्ट में web/index.html फ़ाइल खोलें.
  2. <head> टैग में यह स्क्रिप्ट टैग जोड़ें. साथ ही, YOUR_API_KEY के लिए अपनी एपीआई पासकोड डालें.
    <script>
      (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
        key: "YOUR_API_KEY",
        v: "weekly",
        // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
        // Add other bootstrap parameters as needed, using camel case.
      });
    </script>
  3. index.html फ़ाइल को सेव करके बंद करें.

    index.html का पूरा head सेक्शन, कुछ ऐसा दिखना चाहिए:

        <head>
          <base href="/">
          
          <meta charset="UTF-8">
          <meta content="IE=Edge" http-equiv="X-UA-Compatible">
          <meta name="description" content="A new Flutter project.">
          
          <!-- iOS meta tags & icons -->
          <meta name="apple-mobile-web-app-capable" content="yes">
          <meta name="apple-mobile-web-app-status-bar-style" content="black">
          <meta name="apple-mobile-web-app-title" content="google_maps_in_flutter">
          <link rel="apple-touch-icon" href="icons/Icon-192.png">
          
          <script>
            (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
              key: "YOUR_API_KEY",
              v: "weekly",
              // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
              // Add other bootstrap parameters as needed, using camel case.
              });
          </script>
          
          <title>google_maps_in_flutter</title>
          <link rel="manifest" href="manifest.json">
        </head>

पांचवां चरण: मैप जोड़ना

यहां दिए गए कोड में, नए Flutter ऐप्लिकेशन में आसान मैप जोड़ने का तरीका बताया गया है.

  1. अपने पसंदीदा IDE की मदद से, Flutter प्रोजेक्ट में lib/main.dart फ़ाइल खोलें.
  2. mapController का इंस्टेंस बनाने और उसे शुरू करने के लिए, अपने ऐप्लिकेशन के डिफ़ॉल्ट मुख्य तरीके में तरीके जोड़ें या अपडेट करें.
          import 'package:flutter/material.dart';
          import 'package:google_maps_flutter/google_maps_flutter.dart';
          
          void main() => runApp(const MyApp());
          
          class MyApp extends StatefulWidget {
            const MyApp({super.key});
          
            @override
            State<MyApp> createState() => _MyAppState();
          }
          
          class _MyAppState extends State<MyApp> {
            late GoogleMapController mapController;
          
            final LatLng _center = const LatLng(-33.86, 151.20);
          
            void _onMapCreated(GoogleMapController controller) {
              mapController = controller;
            }
          
            @override
            Widget build(BuildContext context) {
              return MaterialApp(
                home: Scaffold(
                  appBar: AppBar(
                    title: const Text('Maps Sample App'),
                    backgroundColor: Colors.green[700],
                  ),
                  body: GoogleMap(
                    onMapCreated: _onMapCreated,
                    initialCameraPosition: CameraPosition(
                      target: _center,
                      zoom: 11.0,
                    ),
                  ),
                ),
              );
            }
          }
  3. उन सभी एम्युलेटर या डिवाइसों को चालू करें जिन पर आपको अपना ऐप्लिकेशन चलाना है.
  4. अपना ऐप्लिकेशन चलाएं. आपको ऐसा आउटपुट दिखेगा:
      flutter run
    
       
        Multiple devices found:
        Android phone (mobile) • emulator-5554 • android-arm64  • Android 13 (API 33) (emulator)
        iPhone (mobile)  • ios • com.apple.CoreSimulator.SimRuntime.iOS-16-2 (simulator)
        Chrome (web) • chrome • web-javascript • Google Chrome 108.0.5359.124
        [1]: Android phone
        [2]: iPhone
        [3]: Chrome
        
        Please choose one (To quit, press "q/Q"): 

    उस प्लैटफ़ॉर्म का नंबर टाइप करें जिसे आपको चलाना है. flutter run को हर बार इस्तेमाल करने पर, Flutter आपको ये विकल्प दिखाएगा. अगर आपके डेवलपमेंट सिस्टम में कोई एमुलेटर नहीं चल रहा है या कोई टेस्ट डिवाइस कनेक्ट नहीं है, तो Flutter को Chrome खोलना चाहिए.

    हर प्लैटफ़ॉर्म पर, सिडनी, ऑस्ट्रेलिया के बीच में मैप दिखना चाहिए. अगर आपको मैप नहीं दिखता है, तो देखें कि आपने सही टारगेट प्रोजेक्ट में अपनी एपीआई पासकोड जोड़ा है या नहीं.

अगले चरण

अब आपके पास एपीआई कुंजी और Flutter प्रोजेक्ट है. इसलिए, अब ऐप्लिकेशन बनाए जा सकते हैं और उन्हें चलाया जा सकता है. 'Flutter के लिए Google Maps' पैकेज में कई ट्यूटोरियल और सैंपल ऐप्लिकेशन उपलब्ध हैं. इनकी मदद से, आपको शुरू करने में मदद मिल सकती है. ज़्यादा जानने के लिए, नीचे दिए गए लेख पढ़ें: