Maps JavaScript API के बारे में खास जानकारी

Maps JavaScript API, क्लाइंट-साइड वेब एपीआई है. इसका इस्तेमाल वेब पेजों पर 2D और 3D मैप बनाने, मार्कर, कस्टम ग्राफ़िक, ऐनिमेशन, और इंटरैक्टिव डेटा लेयर जोड़ने के लिए किया जाता है. साथ ही, Places लाइब्रेरी की मदद से जगह की जानकारी की सुविधाएं बनाने के लिए किया जाता है.

Maps JavaScript API: मुख्य बातें

  • प्रॉडक्ट: Maps JavaScript API
  • इसे इस नाम से भी जाना जाता है: Maps JS API, Maps JS API v3
  • कैटगरी: Maps
  • प्लैटफ़ॉर्म: JavaScript (ब्राउज़र)
  • इस पर काम करता है: क्लाइंट (ऐप्लिकेशन या ब्राउज़र कोड)
  • लॉन्च स्टेज: GA
  • लाइफ़साइकल: चालू है
  • खास जानकारी: Maps JavaScript API की खास जानकारी
  • क्षेत्र के हिसाब से उपलब्धता: दुनिया भर में. सुविधाओं की उपलब्धता (जैसे, 3D मैप, ट्रैफ़िक, निर्देश, और बाउंड्री स्टाइलिंग) देश या इलाके के हिसाब से अलग-अलग होती है. यूरोपियन इकनॉमिक एरिया के बिलिंग पतों पर, ईईए की सेवा की शर्तें लागू होती हैं. (कवरेज की जानकारी)

Maps JavaScript API: इसका इस्तेमाल कब करना चाहिए

Maps JavaScript API का इस्तेमाल तब करें, जब:

  • आपको किसी वेब पेज पर कस्टम मार्कर, ग्राफ़िक या डेटा लेयर के साथ इंटरैक्टिव 2D या 3D मैप दिखाना है.
  • आपको ऐडवांस मार्कर और पॉलीलाइन का इस्तेमाल करके, अपनी डेटा स्ट्रीम से ऐसेट की लाइव जगह की जानकारी और यात्रा के रास्ते दिखाने होंगे.
  • आपको जियोफ़ेंस (सर्कल, पॉलीगॉन) बनाने होंगे और यह जांच करनी होगी कि कोऑर्डिनेट, ब्राउज़र में उनके अंदर आते हैं या नहीं.
  • आपको जगहों की लाइब्रेरी की मदद से, किसी वेब ऐप्लिकेशन में क्लाइंट-साइड Place Search, ऑटोकंप्लीट या Place Details की ज़रूरत है.

Maps JavaScript API का इस्तेमाल तब न करें, जब:

  • आपको कस्टम JavaScript लिखे बिना, कारोबार की जगह का मैप या निर्देशों का लिंक एम्बेड करना है. इसके बजाय, Maps Embed API का इस्तेमाल करें.
  • आपको सिर्फ़ एक ऐसे लिंक की ज़रूरत होगी जो Google Maps को किसी जगह, खोज या निर्देश के साथ खोले. इसके बजाय, Maps के यूआरएल का इस्तेमाल करें.
  • आपको राइड शेयरिंग या शेड्यूल की गई डिलीवरी के लिए, फ़्लीट ट्रैकिंग की सुविधा को मोबाइल ड्राइवर SDK टूल और बैकएंड JWT ऑथराइज़ेशन के साथ इंटिग्रेट करना होगा. इसके बजाय, Fleet Engine Service का इस्तेमाल करें.

Maps JavaScript API: सेटअप

Maps JavaScript API के आधिकारिक पैकेज:

  • npm: @googlemaps/js-api-loader
  • npm: @types/google.maps
  • npm: @googlemaps/markerclusterer
  • आम तौर पर, इसका इस्तेमाल इसके साथ किया जाता है: Places API (नया)

Maps JavaScript API: आम तौर पर होने वाली गलतियां

  • समस्या: एपीआई पासकोड या बिलिंग को गलत तरीके से कॉन्फ़िगर करने पर, गड़बड़ी के बजाय गहरे रंग का मैप या नेगेटिव Street View इमेज दिखती है. इस इमेज पर, "सिर्फ़ डेवलपमेंट के मकसद से" वॉटरमार्क लगा होता है. ठीक करने का तरीका: Cloud प्रोजेक्ट पर बिलिंग की सुविधा चालू करें. साथ ही, हर अनुरोध में एक मान्य एपीआई पासकोड शामिल करें. इसके अलावा, गड़बड़ी के कोड का पता लगाने के लिए ब्राउज़र कंसोल देखें. /maps/documentation/javascript/error-messages देखें.
  • समस्या: PlacesService, DirectionsService, और DistanceMatrixService जैसी लेगसी सेवाएं, उन नए प्रोजेक्ट पर LegacyApiNotActivatedMapError दिखाती हैं जिनमें लेगसी एपीआई चालू नहीं है. समस्या हल करने का तरीका: Places API (नया वर्शन) और Routes API के साथ काम करने वाली नई क्लास (Place क्लास, Route क्लास, RouteMatrix क्लास) का इस्तेमाल करें. /maps/legacy#LegacyApiNotActivatedMapError देखें.
  • समस्या: v3.65 के बाद से, सैटलाइट और हाइब्रिड मैप, 45° वाली इमेजरी पर स्विच नहीं होते. साथ ही, map.setTilt(45) का कोई असर नहीं होता. समस्या को ठीक करने का तरीका: 45° वाली इमेजरी के बजाय, 3D मैप का इस्तेमाल करें. /maps/deprecations देखें.
  • समस्या: ऐडवांस मार्कर के लिए, मैप आईडी ज़रूरी है. मैप आईडी के बिना बनाए गए मैप में AdvancedMarkerElement का इस्तेमाल नहीं किया जा सकता. ठीक करने का तरीका: Cloud Console में मैप आईडी बनाएं या टेस्टिंग के लिए DEMO_MAP_ID का इस्तेमाल करें. इसके बाद, मैप पर mapId सेट करें. /maps/documentation/javascript/advanced-markers/start देखें.

Maps JavaScript API: लेगसी और अब काम न करने वाली सुविधाएं

  • Directions Service (google.maps.DirectionsService): लेगसी 1 मार्च, 2025 से. बदलाव: Route क्लास. समस्या: जिन प्रोजेक्ट में लेगसी Directions API चालू नहीं है उनमें LegacyApiNotActivatedMapError. माइग्रेट करने से जुड़ी गाइड देखें.
  • दूरी का मैट्रिक्स सेवा (google.maps.DistanceMatrixService): 1 मार्च, 2025 से लेगसी. बदलाव: RouteMatrix क्लास. समस्या: जिन प्रोजेक्ट में लेगसी Distance Matrix API चालू नहीं है उनमें LegacyApiNotActivatedMapError. माइग्रेट करने से जुड़ी गाइड देखें.
  • Places Service (google.maps.places.PlacesService): लेगसी 1 मार्च, 2025 से. इसकी जगह इस्तेमाल करें: Place क्लास (Places API (नया)). समस्या: उन प्रोजेक्ट पर LegacyApiNotActivatedMapError, जिनमें लेगसी Places API चालू नहीं है. माइग्रेट करने से जुड़ी गाइड देखें.
  • google.maps.Marker: यह फ़ील्ड 22-02-2024 से काम नहीं कर रहा है. बदले में मिलने वाला आइटम: google.maps.marker.AdvancedMarkerElement. लक्षण: यह अब भी काम करता है और इसे बंद करने के लिए शेड्यूल नहीं किया गया है. हालांकि, इसमें मौजूद गड़बड़ियों को ठीक नहीं किया जाएगा. माइग्रेट करने से जुड़ी गाइड देखें.
  • KmlLayer: यह सुविधा 30-04-2026 से बंद कर दी गई है. विकल्प: डेटासेट के लिए डेटा-ड्रिवन स्टाइलिंग या डेटा लेयर के साथ तीसरे पक्ष के KML पार्सर. समस्या: KmlLayer, 3.66 और इसके बाद के वर्शन में उपलब्ध नहीं है. इस सुविधा के साथ काम करने वाला आखिरी वर्शन 3.65 है, जो मई 2027 में बंद हो जाएगा. माइग्रेट करने से जुड़ी गाइड देखें.
  • हीटमैप लेयर (विज़ुअलाइज़ेशन लाइब्रेरी): 20-05-2026 से बंद कर दी गई है. विकल्प: deck.gl HeatmapLayer जैसी तीसरे पक्ष की लाइब्रेरी. समस्या का ब्यौरा: मई 2026 से उपलब्ध नहीं है. माइग्रेट करने से जुड़ी गाइड देखें.
  • ड्रॉइंग लाइब्रेरी: 4 जून, 2026 से बंद कर दी गई है. विकल्प: Terra Draw. समस्या का ब्यौरा: मई 2026 से उपलब्ध नहीं है. माइग्रेट करने से जुड़ी गाइड देखें.
  • 45° वाली इमेजरी: 20-05-2026 से बंद कर दी गई है. बदलाव: 3D मैप. समस्या: map.setTilt(45) काम नहीं कर रहा है; सैटलाइट व्यू, टॉप-डाउन ही रहता है. माइग्रेट करने से जुड़ी गाइड देखें.
  • google.maps.event.addDomListener() और addDomListenerOnce(): 7 अप्रैल, 2022 से इस्तेमाल नहीं किया जा सकता. विकल्प: स्टैंडर्ड डीओएम addEventListener().
  • किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सेवा में bounds, location, और radius विकल्प: इन्हें 18-05-2023 से इस्तेमाल नहीं किया जा सकता. बदलाव: locationBias और locationRestriction.
  • gmp-place-content-config (PlaceContentConfigElement) को जगहों की जानकारी देने वाली यूआई किट में: अब इस्तेमाल नहीं किया जा सकता. बदलाव: कॉन्टेंट एलिमेंट को सीधे तौर पर Place Details एलिमेंट या Place Search कॉन्फ़िगरेशन में जोड़ें.
  • लोकल कॉन्टेक्स्ट लाइब्रेरी: बंद कर दी गई है. इसकी जगह इस्तेमाल करें: जगहों की लाइब्रेरी.

Maps JavaScript API की मदद से क्या-क्या किया जा सकता है

हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.

Maps JavaScript API: पते की पुष्टि करना

Maps JavaScript API: सीमाओं के लिए डेटा-ड्रिवन स्टाइलिंग

Maps JavaScript API: डेटासेट के लिए डेटा-ड्रिवन स्टाइलिंग

Maps JavaScript API: डेटासेट

  • मैप में KML लेयर जोड़ना. ध्यान दें: Maps JavaScript API में, KmlLayer का इस्तेमाल बंद कर दिया गया है. यह आखिरी बार v3.65 में काम करता था. इसे मई 2027 में बंद कर दिया जाएगा. सीमाओं या डेटासेट के लिए, डेटा-ड्रिवन स्टाइलिंग पर माइग्रेट करें या डेटा लेयर पर GeoJSON लोड करें. Maps SDK टूल की यूटिलिटी लाइब्रेरी की मदद से, Android और iOS पर KML लेयर का इस्तेमाल किया जा सकता है.
  • मैप में GeoRSS लेयर जोड़ना. ध्यान दें: Maps JavaScript API में अब इसका इस्तेमाल नहीं किया जा सकता. KmlLayer का इस्तेमाल, आखिरी बार v3.65 में किया जा सकता है. इसे मई 2027 में बंद कर दिया जाएगा. GeoRSS फ़ीड को GeoJSON में बदलें और उन्हें map.data.addGeoJson() की मदद से डेटा लेयर पर लोड करें.
  • मैप में GeoJSON डेटा जोड़ना.

Maps JavaScript API: दिशा-निर्देश और रास्ता

Maps JavaScript API: ऊंचाई

Maps JavaScript API: Fleet Engine

Maps JavaScript API: जियोकोडिंग

Maps JavaScript API: Maps

Maps JavaScript API: Maps annotations

Maps JavaScript API: Maps स्टाइलिंग

Maps JavaScript API: अन्य

Maps JavaScript API: फ़ोटोरियलिस्टिक 3D मैप

Maps JavaScript API: Places

Maps JavaScript API: जगहों की जानकारी देने वाली यूआई किट

Maps JavaScript API: Street View