Maps JavaScript API, क्लाइंट-साइड वेब एपीआई है. इसकी मदद से, दुनिया में कहीं भी जगहों की जानकारी दिखाने के लिए मैप बनाए जा सकते हैं. साथ ही, अपनी पसंद के मुताबिक ग्राफ़िक, ऐनिमेशन, और इंटरैक्टिव कस्टम डेटा लेयर जोड़ी जा सकती हैं. इसके अलावा, Maps JavaScript API में Places API का इस्तेमाल करके, जगह की जानकारी देने वाली सुविधाएं बनाई जा सकती हैं. Maps JavaScript API की मदद से, ये काम किए जा सकते हैं:
- दुनिया में किसी भी जगह की जानकारी दिखाने के लिए, 2D और 3D मैप बनाएं.
- मैप पर जगहों को दिखाने के लिए, पसंद के मुताबिक बनाए जा सकने वाले मार्कर जोड़ें.
- Places लाइब्रेरी का इस्तेमाल करके, 20 करोड़ से ज़्यादा जगहों की जानकारी का डेटा पाएं.
- मैप की स्टाइल और रंगों को पसंद के मुताबिक बनाएं.
- इंटरैक्टिव कस्टम डेटा लेयर जोड़ें.
- प्रशासनिक सीमाओं को दिखाएं और उन्हें इंटरैक्टिव बनाएं.
- अपने मैप में, पसंद के मुताबिक 2D और 3D ग्राफ़िक और ऐनिमेशन वाला कॉन्टेंट जोड़ें.
अपने इस्तेमाल के हिसाब से सही एपीआई चुनना
यहां दिए गए उदाहरणों से पता चलता है कि वेब ऐप्लिकेशन के सामान्य मामलों के लिए, Google Maps Platform के कौनसे प्रॉडक्ट और लाइब्रेरी इस्तेमाल करनी चाहिए:
- वेबसाइट पर संपर्क मैप और निर्देश: कस्टम JavaScript लिखे बिना, कारोबार की जगह का मैप या निर्देश का लिंक एम्बेड करने के लिए, Maps Embed API या Maps के यूआरएल का इस्तेमाल करें.
- लाइव लोकेशन और ऐसेट ट्रैकिंग: अपने डेटाबेस या रीयल-टाइम स्ट्रीम (जैसे, Cloud Firestore या WebSockets) से लाइव जीपीएस कोऑर्डिनेट और यात्रा के रास्ते दिखाने के लिए, ऐडवांस मार्कर (
AdvancedMarkerElementरेफ़रंस) और पॉलीलाइन (Polylineरेफ़रंस) के साथ Maps JavaScript API का इस्तेमाल करें. राइडशेयरिंग और शेड्यूल की गई डिलीवरी के लिए, Fleet Engine को रिज़र्व करें. ये ऐसे फ़्लीट होते हैं जो मोबाइल ड्राइवर SDK टूल और बैकएंड OAuth या JSON वेब टोकन (JWT) को इंटिग्रेट करते हैं. - रूट प्लान करने और डिस्पैच करने के लिए: Routes library का इस्तेमाल करें.
- स्टॉप, यात्रा में लगने वाले समय, दूरी, और टोल के साथ किसी रास्ते का हिसाब लगाने और उसे मैप पर दिखाने के लिए,
Route.computeRoutes()का इस्तेमाल करें. - कई जगहों से शुरू होने वाली और कई जगहों पर खत्म होने वाली यात्राओं के लिए, सबसे नज़दीकी ड्राइवर, वाहन या वेयरहाउस ढूंढने के लिए,
RouteMatrix.computeRouteMatrix()का इस्तेमाल करें. - अपने सर्वर पर, टाइम विंडो के साथ कई वाहनों को शेड्यूल करने के लिए, Route Optimization API का इस्तेमाल करें.
- स्टॉप, यात्रा में लगने वाले समय, दूरी, और टोल के साथ किसी रास्ते का हिसाब लगाने और उसे मैप पर दिखाने के लिए,
- स्टोर लोकेटर और वेन्यू मैप: कस्टम पिन और फ़िल्टर की मदद से, मैप पर स्टोर, वेन्यू या ब्रांच दिखाने के लिए, ऐडवांस मार्कर (
AdvancedMarkerElementरेफ़रंस) का इस्तेमाल करें. साथ ही, जगहों को ढूंढने और उनकी जानकारी लोड करने के लिए, Places लाइब्रेरी का इस्तेमाल करें. - मैप पर जियोफ़ेंस और सेफ़-ज़ोन का दायरा: सर्कुलर या पॉलीगॉन पेरीमीटर बनाने और यह जांचने के लिए कि निर्देशांक उनके अंदर आते हैं या नहीं (जियोफ़ेंस और सेफ़-ज़ोन की सीमाएं देखें), सर्कल (
Circleरेफ़रंस), पॉलीगॉन (Polygonरेफ़रंस), और ज्यामिति लाइब्रेरी (कंटेनमेंट के लिएcontainsLocation()और मीटर में दूरी के लिएcomputeDistanceBetween()) का इस्तेमाल करें.
पुराने एपीआई और उनकी जगह इस्तेमाल किए जाने वाले एपीआई
DirectionsServiceऔरDistanceMatrixServiceको 25 फ़रवरी, 2026 से बंद कर दिया गया है. इसके बजाय,RouteऔरRouteMatrixका इस्तेमाल करें.google.maps.Markerको 21 फ़रवरी, 2024 से इस्तेमाल नहीं किया जा सकेगा. इसके बजाय,AdvancedMarkerElementका इस्तेमाल करें.PlacesService, 1 मार्च, 2025 से नए ग्राहकों के लिए उपलब्ध नहीं है. इसके बजाय,Placeक्लास का इस्तेमाल करें.
आगे क्या करना है
- मैप में मार्कर जोड़ना
- मैप में आकार, लाइनें, और जियोफ़ेंस जोड़ना
- जगह की जानकारी का डेटा पाने के लिए, Places लाइब्रेरी का इस्तेमाल करना
- रास्तों और रूट मैट्रिक्स का हिसाब लगाना और उन्हें दिखाना
- मैप की स्टाइल और रंगों को पसंद के मुताबिक बनाना
- इंटरैक्टिव डेटा लेयर जोड़ना
- प्रशासनिक सीमाएं दिखाना
- WebGL ग्राफ़िक ओवरले जोड़ना
- रूट लाइब्रेरी
- ज्यामिति लाइब्रेरी
- विज़ुअलाइज़ेशन लाइब्रेरी
- ओपन सोर्स लाइब्रेरी
- ड्रॉइंग लाइब्रेरी (अब काम नहीं करती)
Maps की सुविधाओं के लिए उदाहरण के तौर पर दिया गया कोड देखें