Flutter प्रोजेक्ट सेट अप करने से पहले, पक्का करें कि आपने शुरू करने से पहले सेक्शन में दी गई ज़रूरी शर्तें पूरी कर ली हों. बिलिंग की सुविधा चालू करने और एपीआई कुंजी बनाने के बाद, उस Flutter प्रोजेक्ट को सेट अप किया जा सकता है जिसका इस्तेमाल ऐप्लिकेशन डेवलप करने के लिए किया जाता है.
पहला चरण: ज़रूरी सॉफ़्टवेयर इंस्टॉल करना
Google Maps for Flutter पैकेज का इस्तेमाल करके कोई प्रोजेक्ट बनाने के लिए, आपको Flutter SDK टूल इंस्टॉल करना होगा. साथ ही, टारगेट प्लैटफ़ॉर्म के लिए डेवलपमेंट एनवायरमेंट सेट अप करना होगा. ज़्यादा जानकारी के लिए, Flutter को इंस्टॉल करने से जुड़ी गाइड देखें.
दूसरा चरण: नए प्रोजेक्ट में Google Maps for Flutter पैकेज इंस्टॉल करना
Flutter, Google Maps for Flutter पैकेज को Flutter प्लगिन के तौर पर उपलब्ध कराता है.
Flutter प्रोजेक्ट बनाएं और Maps प्लगिन जोड़ें.
-
`flutter create` का इस्तेमाल करके, नया Flutter प्रोजेक्ट बनाएं:
आपका ऐप्लिकेशन कोडflutter create google_maps_in_flutter --platforms=android,ios,webCreating project google_maps_in_flutter... [Listing of created files elided] Wrote 127 files. All done!google_maps_in_flutter/lib/main.dartमें है. अपने ऐप्लिकेशन को चलाने के लिए, यह टाइप करें: यह ऐप्लिकेशन iOS, Android, और वेब को टारगेट करता है. फ़िलहाल, Google Maps SDK, ब्राउज़र के बाहर डेस्कटॉप ऐप्लिकेशन के साथ काम नहीं करता.cd google_maps_in_flutterflutter run -
इस प्रोजेक्ट में, Google Maps for Flutter पैकेज प्लगिन जोड़ें.
flutter pub add google_maps_flutterResolving dependencies... [Listing of dependencies elided] Changed 14 dependencies!
तीसरा चरण: प्लैटफ़ॉर्म का वर्शन सेट करना
Android
Android के लिए, एसडीके का कम से कम लेवल वाला वर्शन सेट करें.
- अपने पसंदीदा IDE में
android/app/build.gradleकॉन्फ़िगरेशन फ़ाइल खोलें. 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 } //... }defaultConfigको कॉन्फ़िगर करते समय, अपना यूनीक ApplicationID डालें.- अपने प्रोजेक्ट में किए गए बदलावों को Gradle के साथ सिंक करें.
iOS
iOS प्लैटफ़ॉर्म का कम से कम वर्शन सेट करें.
- अपने पसंदीदा IDE में
ios/Podfileकॉन्फ़िगरेशन फ़ाइल खोलें. - इस 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 के लिए सीक्रेट ग्रेडल प्लग इन का इस्तेमाल करें.
Android के लिए Secrets Gradle Plugin इंस्टॉल करने और अपनी एपीआई कुंजी सेव करने के लिए:
-
Android Studio में, अपनी रूट-लेवल की
build.gradleफ़ाइल खोलें. इसके बाद,buildscriptमें मौजूदdependenciesएलिमेंट में यह कोड जोड़ें.ग्रूवी
buildscript { dependencies { // ... classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1" } }
Kotlin
buildscript { dependencies { // ... classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1") } }
-
ऐप्लिकेशन-लेवल की
build.gradleफ़ाइल खोलें औरpluginsएलिमेंट में यह कोड जोड़ें.ग्रूवी
plugins { id 'com.android.application' // ... id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' }
Kotlin
plugins { id("com.android.application") // ... id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") }
- अगर Android Studio का इस्तेमाल किया जाता है, तो अपने प्रोजेक्ट को Gradle के साथ सिंक करें.
-
अपने प्रोजेक्ट लेवल की डायरेक्ट्री में मौजूद
local.propertiesखोलें. इसके बाद, यह कोड जोड़ें.YOUR_API_KEYको अपने एपीआई पासकोड से बदलें.MAPS_API_KEY=YOUR_API_KEY
-
अपनी
AndroidManifest.xmlफ़ाइल में,com.google.android.geo.API_KEYपर जाएं औरandroid:valueएट्रिब्यूट को इस तरह अपडेट करें:<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 के लिए पुष्टि की जा सकती है. कोई ऐप्लिकेशन, एपीआई कुंजी के मेटाडेटा के सिर्फ़ एक नाम के बारे में बता सकता है. अगर दोनों को तय किया जाता है, तो एपीआई एक अपवाद दिखाता है.
ध्यान दें: ऊपर दिखाए गए तरीके के मुताबिक, एपीआई पासकोड के लिए com.google.android.geo.API_KEY मेटाडेटा का नाम इस्तेमाल करने का सुझाव दिया जाता है. इस नाम वाली कुंजी का इस्तेमाल, Android प्लैटफ़ॉर्म पर Google Maps पर आधारित कई एपीआई के लिए पुष्टि करने के लिए किया जा सकता है. इनमें Flutter SDK भी शामिल है. पुराने सिस्टम के साथ काम करने की सुविधा के लिए, API com.google.android.maps.v2.API_KEY नाम का इस्तेमाल भी किया जा सकता है. इस लेगसी नाम से, सिर्फ़ Android Maps API v2 के लिए पुष्टि की जा सकती है. कोई ऐप्लिकेशन, एपीआई कुंजी के मेटाडेटा के सिर्फ़ एक नाम के बारे में बता सकता है. अगर दोनों को तय किया जाता है, तो एपीआई एक अपवाद दिखाता है.
iOS
अपनी AppDelegate.swift फ़ाइल में एपीआई पासकोड जोड़ें.
- अपने पसंदीदा IDE में, अपने Flutter प्रोजेक्ट की
ios/Runner/AppDelegate.swiftफ़ाइल खोलें. - अपने ऐप्लिकेशन में Google Maps for Flutter पैकेज जोड़ने के लिए, यह इंपोर्ट स्टेटमेंट जोड़ें:
- अपने एपीआई को
application(_:didFinishLaunchingWithOptions:)तरीके में जोड़ें. इसके लिए, अपनी एपीआई कुंजी को YOUR_API_KEY से बदलें:GMSServices.provideAPIKey("YOUR_API_KEY") AppDelegate.swiftफ़ाइल को सेव करके बंद करें.
import GoogleMaps
भरी गई 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 ऐप्लिकेशन फ़ाइल में एपीआई पासकोड जोड़ें.
- अपने पसंदीदा IDE में, अपने Flutter प्रोजेक्ट की
web/index.htmlफ़ाइल खोलें. <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>
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 ऐप्लिकेशन में सामान्य मैप जोड़ने का तरीका बताया गया है.
- अपने पसंदीदा IDE में, अपने Flutter प्रोजेक्ट की
lib/main.dartफ़ाइल खोलें. 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, ), ), ), ); } }
- उन सभी एम्युलेटर या डिवाइसों को शुरू करें जिन पर आपको अपना ऐप्लिकेशन चलाना है.
- अपना ऐप्लिकेशन चलाएं. आपको इससे मिलता-जुलता आउटपुट दिखेगा:
flutter runMultiple 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 प्रोजेक्ट है. इसलिए, अब ऐप्लिकेशन बनाए और चलाए जा सकते हैं. Google Maps for Flutter पैकेज में कई ट्यूटोरियल और सैंपल ऐप्लिकेशन उपलब्ध हैं. इनकी मदद से, आपको शुरुआत करने में मदद मिल सकती है. ज़्यादा जानने के लिए, यहां दिए गए संसाधन देखें:
- मार्कर के साथ मैप जोड़ने का ट्यूटोरियल
- Google Maps Platform के साथ Flutter के लिए कोडलैब
- GitHub पर कोड के सैंपल