खास जानकारी
Google Maps Platform, वेब (JS, TS), Android, और iOS के लिए उपलब्ध है. यह जगहों, रास्तों, और दूरियों के बारे में जानकारी पाने के लिए, वेब सेवाओं के एपीआई भी उपलब्ध कराता है. इस गाइड में दिए गए सैंपल, एक प्लैटफ़ॉर्म के लिए लिखे गए हैं. हालांकि, अन्य प्लैटफ़ॉर्म पर लागू करने के लिए, दस्तावेज़ के लिंक दिए गए हैं.
जब लोग आपके प्रॉडक्ट ऑनलाइन देखते हैं, तो वे ऑर्डर पाने का सबसे अच्छा और आसान तरीका ढूंढते हैं. Google Maps Platform के एपीआई का इस्तेमाल करके, बेहतरीन प्रॉडक्ट लोकेटर उपयोगकर्ता अनुभव बनाने के लिए, Google, प्रॉडक्ट लोकेटर को लागू करने के बारे में जानकारी और पसंद के मुताबिक बनाने के सुझावों को सबसे सही कॉम्बिनेशन के तौर पर इस्तेमाल करने का सुझाव देता है.
लागू करने के बारे में जानकारी देने वाली इस गाइड का पालन करके, खरीदारों को आपके प्रॉडक्ट ढूंढने के लिए ज़रूरी जानकारी दिखाई जा सकती है. साथ ही, उन्हें उस स्टोर का रास्ता दिखाया जा सकता है जहां उनका आइटम मौजूद है. भले ही, वे गाड़ी चला रहे हों, साइकल चला रहे हों, पैदल चल रहे हों या सार्वजनिक परिवहन का इस्तेमाल कर रहे हों.
एपीआई चालू करें
प्रॉडक्ट लोकेटर को लागू करने के लिए, आपको Google Cloud Console में ये एपीआई चालू करने होंगे. यहां दिए गए हाइपरलिंक आपको Google Cloud Console पर ले जाते हैं, ताकि आप चुने गए प्रोजेक्ट के लिए हर एपीआई को चालू कर सकें:
सेटअप के बारे में ज़्यादा जानकारी के लिए, Google Maps Platform का इस्तेमाल शुरू करना लेख पढ़ें.
लागू करने के बारे में जानकारी देने वाली गाइड के सेक्शन
यहां, लागू करने और पसंद के मुताबिक बनाने के इन तरीकों के बारे में बताया गया है:
- सही के निशान वाला आइकॉन, लागू करने का एक मुख्य चरण है.
- स्टार आइकॉन, कस्टमाइज़ेशन का एक विकल्प है. हालांकि, हमारा सुझाव है कि आप इसका इस्तेमाल करें, ताकि समाधान को बेहतर बनाया जा सके.
| स्टोर की जगहों को Google Maps Platform पर मौजूद जगहों से जोड़ना | स्टोर की जगह की जानकारी को Google Maps Platform में मौजूद किसी जगह से मैच करना. | |
| उपयोगकर्ता की जगह की जानकारी की पहचान करना | सभी प्लैटफ़ॉर्म पर उपयोगकर्ता अनुभव को बेहतर बनाने के लिए, टाइप-ऐज़-यू-गो की सुविधा जोड़ें. साथ ही, कम से कम कीस्ट्रोक के साथ पते की सटीक जानकारी को बेहतर बनाएं. | |
| सबसे नज़दीकी स्टोर की पहचान करना | शुरुआत की कई जगहों से अलग-अलग मंज़िलों तक की यात्रा में लगने वाले समय और दूरी कैलकुलेट करें. इसके लिए, यात्रा के अलग-अलग मोड भी चुने जा सकते हैं. जैसे, पैदल, ड्राइविंग, सार्वजनिक परिवहन या साइकल. | |
| स्टोर की जानकारी दिखाना | अपने स्टोर के बारे में ज़्यादा जानकारी दिखाएं, ताकि उपयोगकर्ता आसानी से आपके स्टोर तक पहुंच सकें. | |
| नेविगेशन के निर्देश देना | यात्रा के अलग-अलग मोड (पैदल चलना, ड्राइविंग, साइकल चलाना, और बस, मेट्रो वगैरह का इस्तेमाल करना) के हिसाब से, सफ़र शुरू करने की जगह से मंज़िल तक के रास्ते की जानकारी पाएं. | |
| मोबाइल पर दिशा-निर्देश भेजना | अपने वेबपेज पर रास्ता दिखाने के साथ-साथ, किसी उपयोगकर्ता के फ़ोन पर भी रास्ता भेजा जा सकता है. इससे वह Google Maps का इस्तेमाल करके, कहीं भी जाते समय रास्ता देख सकता है. | |
| इंटरैक्टिव मैप पर अपनी जगहों की जानकारी दिखाना | ज़रूरत के मुताबिक तैयार मैप मार्कर बनाएं, ताकि आपकी जगहों की जानकारी अलग से दिखे. साथ ही, मैप को अपने ब्रैंड के रंगों के हिसाब से स्टाइल करें. अपने मैप पर, लोकप्रिय जगहों (पीओआई) को दिखाएं या छिपाएं. इससे उपयोगकर्ताओं को अपनी जगह की जानकारी बेहतर तरीके से समझने में मदद मिलती है. साथ ही, मैप पर ज़्यादा जानकारी दिखने से रोकने के लिए, पीओआई की डेंसिटी को कंट्रोल करें. | |
| जगह की जानकारी के साथ, कस्टम जगह की जानकारी का डेटा जोड़ना | जगह की जानकारी के साथ, अपनी पसंद के मुताबिक जगह की जानकारी जोड़ें. इससे उपयोगकर्ताओं को फ़ैसले लेने के लिए, ज़्यादा डेटा मिलेगा. |
स्टोर की जगहों को Google Maps Platform की जगहों से जोड़ना
जगह के आईडी पाना
| इस उदाहरण में इनका इस्तेमाल किया गया है: Places API (नया वर्शन) | यह भी उपलब्ध है: JavaScript |
आपको पता चलेगा कि आपके पास अपने स्टोर का एक डेटाबेस है, जिसमें बुनियादी जानकारी मौजूद है. जैसे, उस जगह का नाम, उसका पता, और उसका फ़ोन नंबर. साथ ही, आपको इसे Google Maps Platform में किसी जगह से जोड़ना है, ताकि आपके उपयोगकर्ता प्रॉडक्ट पिक अप कर सकें. Google Maps Platform के पास उस जगह के बारे में जो जानकारी है उसे फ़ेच करने के लिए, अपने डेटाबेस में मौजूद हर स्टोर से जुड़ा जगह का आईडी ढूंढें. इस जानकारी में, भौगोलिक निर्देशांक और उपयोगकर्ता की ओर से दी गई जानकारी शामिल होती है. Places API (नया) में
टेक्स्ट से खोजें (नया) एंडपॉइंट को कॉल किया जा सकता है. साथ ही, फ़ील्ड मास्क में सिर्फ़ places.id फ़ील्ड का अनुरोध किया जा सकता है. इससे टेक्स्ट सर्च एसेंशियल आईडी ओनली एसकेयू ट्रिगर होता है.
यहां Google के लंदन ऑफ़िस के लिए, जगह के आईडी का अनुरोध करने का उदाहरण दिया गया है:
curl -X POST -d '{
"textQuery" : "Google London"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'इस जगह के आईडी को अपने डेटाबेस में, स्टोर के बाकी डेटा के साथ स्टोर किया जा सकता है. साथ ही, स्टोर के बारे में जानकारी का अनुरोध करने के लिए, इसका इस्तेमाल किया जा सकता है. यहां जगह के आईडी का इस्तेमाल करके, जियोकोड करने, जगह की जानकारी पाने, और जगह तक पहुंचने के लिए निर्देश पाने के तरीके बताए गए हैं.
अपनी जगहों को जियोकोड करना
| इस उदाहरण में इसका इस्तेमाल किया गया है: Geocoding API | यह भी उपलब्ध है: JavaScript |
अगर आपके स्टोर के डेटाबेस में मोहल्ले के पते हैं, लेकिन भौगोलिक निर्देशांक नहीं हैं, तो Geocoding API का इस्तेमाल करके, उस पते के अक्षांश और देशांतर की जानकारी पाएं. इससे यह पता लगाया जा सकता है कि आपके ग्राहक के सबसे नज़दीक कौनसे स्टोर हैं. सर्वर साइड पर स्टोर को जियोकोड किया जा सकता है. साथ ही, अक्षांश और देशांतर को अपने डेटाबेस में सेव किया जा सकता है. इसके अलावा, कम से कम हर 30 दिन में रीफ़्रेश किया जा सकता है.
यहां Geocoding API का इस्तेमाल करके, Google के लंदन ऑफ़िस के लिए दिखाए गए जगह के आईडी के अक्षांश और देशांतर की जानकारी पाने का उदाहरण दिया गया है:
```html
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJVSZzVR8FdkgRTyQkxxLQmVU&key=YOUR_API_KEY&solution_channel=GMP_guides_productlocator_v1_a
```
उपयोगकर्ता की जगह की जानकारी का पता लगाना
| इस उदाहरण में इसका इस्तेमाल किया गया है: Maps JavaScript API में, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा | इनके लिए भी उपलब्ध है: Android | iOS |
प्रॉडक्ट लोकेटर का एक मुख्य कॉम्पोनेंट, आपके उपयोगकर्ता की शुरुआती जगह की पहचान करना है. उपयोगकर्ता को अपनी शुरुआती जगह की जानकारी देने के लिए, दो विकल्प दिए जा सकते हैं: खोज की शुरुआत की जगह टाइप करना या वेब ब्राउज़र की भौगोलिक जगह की जानकारी या मोबाइल की जगह की जानकारी की सेवाओं को अनुमतियां देना.
ऑटोकंप्लीट की सुविधा का इस्तेमाल करके, टाइप की गई एंट्री मैनेज करना
आज के उपयोगकर्ताओं को Google Maps के उपभोक्ता वर्शन पर, ऑटोकंप्लीट टाइप-अहेड सुविधा का इस्तेमाल करने की आदत है. इस सुविधा को किसी भी ऐप्लिकेशन में इंटिग्रेट किया जा सकता है. इसके लिए, मोबाइल डिवाइसों और वेब पर Google Maps Platform की जगहों की लाइब्रेरी का इस्तेमाल किया जा सकता है. जब कोई उपयोगकर्ता पता टाइप करता है, तो ऑटोकंप्लीट की सुविधा, विजेट का इस्तेमाल करके बाकी जानकारी भर देती है. Place Autocomplete Data API का सीधे तौर पर इस्तेमाल करके, ऑटोकंप्लीट की सुविधा भी उपलब्ध कराई जा सकती है.
यहां दिए गए उदाहरण में, Maps JavaScript API स्क्रिप्ट यूआरएल में libraries=places,marker पैरामीटर जोड़कर, अपनी साइट में Places और Marker लाइब्रेरी जोड़ें.
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places,marker&callback=initMap&solution_channel=GMP_guides_productlocator_v1_a" defer></script>इसके बाद, अपने पेज पर एक कंटेनर एलिमेंट जोड़ें, जहां
PlaceAutocompleteElement
विजेट को जोड़ा जाएगा:
<div id="autocomplete-container"></div>आखिर में, PlaceAutocompleteElement विजेट को शुरू करें और उसे कंटेनर में जोड़ें. जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा को includedPrimaryTypes: ["geocode"] के साथ सीमित करने पर, विजेट को मोहल्ले के पते, आस-पड़ोस, शहर, और पिन कोड स्वीकार करने के लिए कॉन्फ़िगर किया जाता है. इससे उपयोगकर्ता, अपनी यात्रा शुरू करने की जगह की जानकारी देने के लिए, किसी भी लेवल की जानकारी डाल सकते हैं. जब कोई उपयोगकर्ता किसी अनुमान को चुनता है, तो gmp-select इवेंट ट्रिगर होता है. इसके बाद, place.fetchFields() को कॉल करके location फ़ील्ड का अनुरोध किया जा सकता है. इस फ़ील्ड में, उपयोगकर्ता की शुरुआती जगह के अक्षांश और देशांतर की जानकारी होती है. इन मैप कोऑर्डिनेट का इस्तेमाल करके, यह बताया जा सकता है कि आपकी जगहों और ओरिजन के बीच क्या संबंध है.
// Create the PlaceAutocompleteElement, restricting predictions to // geographical location types in the United Kingdom. const placeAutocomplete = new google.maps.places.PlaceAutocompleteElement({ includedPrimaryTypes: ["geocode"], includedRegionCodes: ["gb"], }); placeAutocomplete.placeholder = "Enter starting address, city, or zip code"; document.getElementById("autocomplete-container").appendChild(placeAutocomplete); // When the user selects an address from the drop-down, // fetch the place details and search for the nearest stores. placeAutocomplete.addEventListener("gmp-select", async ({ placePrediction }) => { const place = placePrediction.toPlace(); await place.fetchFields({ fields: ["id", "location", "formattedAddress"], }); searchFromOrigin(place); }); }
इस उदाहरण में, उपयोगकर्ता के पता चुनने के बाद, searchFromOrigin() फ़ंक्शन शुरू हो जाता है. यह मैच होने वाले नतीजे की जगह की जानकारी लेता है, जो उपयोगकर्ता की जगह की जानकारी होती है. इसके बाद, उन निर्देशांकों के आधार पर सबसे नज़दीकी जगहों को खोजता है. इसके बारे में सबसे नज़दीकी स्टोर की पहचान करें सेक्शन में बताया गया है.
अपने ऐप्लिकेशन में, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा जोड़ने के बारे में वीडियो देखने के लिए, इसे बड़ा करें:
वेबसाइट
Android ऐप्लिकेशन
iOS ऐप्लिकेशन
ब्राउज़र की भौगोलिक जगह की जानकारी का इस्तेमाल करना
HTML5 ब्राउज़र की भौगोलिक जगह की जानकारी का अनुरोध करने और उसे मैनेज करने के लिए, मेरी जगह की जानकारी का इस्तेमाल करें विंडो को चालू करने का तरीका देखें:
सबसे नज़दीकी स्टोर की पहचान करना
| इस उदाहरण में इनका इस्तेमाल किया गया है: Routes लाइब्रेरी, Maps JavaScript API | यह भी उपलब्ध है: Routes API |
उपयोगकर्ता की जगह की जानकारी मिलने के बाद, इसकी तुलना अपने स्टोर की जगहों से की जा सकती है. Maps JavaScript API की Routes लाइब्रेरी में, RouteMatrix क्लास (या Routes API में Compute Route Matrix सुविधा) का इस्तेमाल करके ऐसा किया जा सकता है. इससे आपके उपयोगकर्ताओं को ड्राइविंग में लगने वाले समय या सड़क की दूरी के हिसाब से, सबसे सुविधाजनक जगह चुनने में मदद मिलती है.
जगहों की सूची को व्यवस्थित करने का स्टैंडर्ड तरीका, उन्हें दूरी के हिसाब से क्रम में लगाना है. अक्सर, इस दूरी का हिसाब लगाने के लिए, उपयोगकर्ता से जगह तक की सीधी लाइन का इस्तेमाल किया जाता है. हालांकि, यह तरीका गुमराह करने वाला हो सकता है. सीधी लाइन, किसी ऐसी नदी के ऊपर से हो सकती है जिसे पार नहीं किया जा सकता या किसी व्यस्त सड़क से होकर गुज़र सकती है. ऐसे में, कोई दूसरी जगह ज़्यादा सुविधाजनक हो सकती है. यह तब ज़रूरी होता है, जब आपके पास कुछ किलोमीटर के दायरे में कई स्टोर हों.
RouteMatrix.computeRouteMatrix मेथड, शुरुआत और मंज़िल की जगहों की सूची लेता है. इसके बाद, यह न सिर्फ़ यात्रा की दूरी दिखाता है, बल्कि उनके बीच यात्रा में लगने वाला समय भी दिखाता है. किसी उपयोगकर्ता के मामले में, ऑरिजिन वह जगह होगी जहां वह फ़िलहाल मौजूद है या जहां से उसे यात्रा शुरू करनी है. वहीं, डेस्टिनेशन वह जगह होगी जहां उसे पहुंचना है. शुरुआती और मंज़िल की जगहों को निर्देशांक के जोड़े, जगह के आईडी या पतों के तौर पर बताया जा सकता है. RouteMatrix.computeRouteMatrix का इस्तेमाल, रूट की प्राथमिकताओं के साथ किया जा सकता है. जैसे, TRAFFIC_AWARE. इससे, मौजूदा या आने वाले समय में ड्राइविंग के समय के आधार पर नतीजे दिखाए जा सकते हैं.
यहां दिए गए उदाहरण में, Maps JavaScript API की Routes Library में RouteMatrix.computeRouteMatrix को कॉल किया गया है. इसमें उपयोगकर्ता की शुरुआत की जगह और एक बार में ज़्यादा से ज़्यादा 25 स्टोर की जगहों की जानकारी दी गई है.
async function getDistances(originLocation) { const { RouteMatrix } = await google.maps.importLibrary("routes"); const request = { origins: [originLocation], destinations: stores.slice(0, 25).map((store) => store.location), travelMode: google.maps.TravelMode.DRIVING, routingPreference: "TRAFFIC_AWARE", fields: ["distanceMeters", "durationMillis", "condition"], }; return RouteMatrix.computeRouteMatrix(request); } function update(location) { if (!location) { return; } // ... // sort by spherical distance stores.sort((a, b) => { return ( google.maps.geometry.spherical.computeDistanceBetween( new google.maps.LatLng(a.location), location ) - google.maps.geometry.spherical.computeDistanceBetween( new google.maps.LatLng(b.location), location ) ); }); // display travel distance and time getDistances(location) .then(({ matrix }) => { const items = matrix.rows[0].items; for (let i = 0; i < items.length; i++) { if (items[i].condition === "ROUTE_EXISTS") { stores[i].travelDistance = items[i].distanceMeters; stores[i].travelDuration = items[i].durationMillis; } } }) .finally(() => { renderCards(stores); autocompleteInput.disabled = false; isUpdateInProgress = false; }); }
आस-पास की हर जगह के लिए, अपने इन्वेंट्री डेटाबेस के आधार पर प्रॉडक्ट के स्टॉक की स्थिति दिखाई जा सकती है.
स्टोर की जानकारी दिखाना
| इस उदाहरण में इनका इस्तेमाल किया गया है: Places Library, Maps JavaScript API | ये भी उपलब्ध हैं: Places SDK for Android | Places SDK for iOS | Places API (नया वर्शन) |
जगह की ज़्यादा जानकारी शेयर की जा सकती है. जैसे, संपर्क जानकारी, कारोबार के खुले होने का समय, और मौजूदा समय में कारोबार के खुले होने की स्थिति. इससे ग्राहकों को अपनी पसंदीदा जगह चुनने या ऑर्डर को फ़ाइनल करने में मदद मिलती है.
जगह की जानकारी पाने के लिए, Maps JavaScript API को कॉल करने के बाद, रिस्पॉन्स को फ़िल्टर और रेंडर किया जा सकता है.
जगह की जानकारी का अनुरोध करने के लिए, आपको अपनी हर जगह का आईडी चाहिए होगा. अपनी जगह का आईडी पाने के लिए, जगह के आईडी पाएं देखें.
जगह की जानकारी के लिए किए गए इस अनुरोध में, Place क्लास का इस्तेमाल किया जाता है. इससे Google London के जगह के आईडी के लिए नाम, निर्देशांक, वेबसाइट, फ़ोन नंबर, रेटिंग, और खुले होने का समय जैसी जानकारी मिलती है:
const place = new google.maps.places.Place({ id: 'ChIJVSZzVR8FdkgRTyQkxxLQmVU', });await place.fetchFields({ fields: [ 'displayName', 'nationalPhoneNumber', 'location', 'regularOpeningHours', 'rating', 'utcOffsetMinutes', 'websiteURI', ], });
createMarker(place);
प्रॉडक्ट लोकेटर को बेहतर बनाना
अपने कारोबार या उपयोगकर्ताओं की ज़रूरतों के हिसाब से, उपयोगकर्ताओं के अनुभव को और बेहतर बनाया जा सकता है.
नेविगेशन के लिए निर्देश देना
| इस उदाहरण में इनका इस्तेमाल किया गया है: Routes लाइब्रेरी, Maps JavaScript API | यह भी उपलब्ध है: Routes API वेब सेवा, जिसका इस्तेमाल Android और iOS पर किया जा सकता है. इसके लिए, सीधे ऐप्लिकेशन से या सर्वर प्रॉक्सी के ज़रिए रिमोट तरीके से ऐक्सेस किया जा सकता है |
अपनी साइट या ऐप्लिकेशन से उपयोगकर्ताओं को निर्देश दिखाने पर, उन्हें आपकी साइट से बाहर जाने की ज़रूरत नहीं पड़ती. साथ ही, वे अन्य पेजों पर नहीं भटकते या मैप पर प्रतिस्पर्धियों को नहीं देखते. Routes API की मदद से, ईको-फ़्रेंडली रास्तों का अनुरोध भी किया जा सकता है. इससे ईंधन या ऊर्जा के इस्तेमाल का अनुमान लगाया जा सकता है. साथ ही, यात्रा से पर्यावरण पर पड़ने वाले असर को दिखाया जा सकता है.
Maps JavaScript API की Routes लाइब्रेरी में मौजूद Route क्लास में, createPolylines() और createWaypointAdvancedMarkers() जैसे तरीके भी होते हैं. इनकी मदद से, नतीजों को प्रोसेस किया जा सकता है और उन्हें मैप पर दिखाया जा सकता है.
यहां मैप पर रास्ते का अनुरोध करने और उसे दिखाने का उदाहरण दिया गया है. सैंपल के बारे में ज़्यादा जानकारी के लिए, कोई रास्ता पाएं लेख पढ़ें.
मोबाइल पर रास्ते की जानकारी भेजना
उपयोगकर्ताओं के लिए किसी जगह पर पहुंचना और भी आसान बनाने के लिए, उन्हें टेक्स्ट या ईमेल के ज़रिए दिशा-निर्देशों का लिंक भेजा जा सकता है. इस पर क्लिक करने पर, अगर उनके फ़ोन में Google Maps ऐप्लिकेशन इंस्टॉल है, तो वह खुल जाएगा. अगर ऐसा नहीं है, तो उनके डिवाइस के वेब ब्राउज़र में maps.google.com लोड हो जाएगा. इन दोनों अनुभवों में, उपयोगकर्ता को मंज़िल तक पहुंचने के लिए, रास्ते के दिशा-निर्देशों का इस्तेमाल करने का विकल्प मिलता है. इसमें आवाज़ से रास्ता बताने की सुविधा भी शामिल है.
Maps के यूआरएल का इस्तेमाल करके, दिशा-निर्देशों वाला यूआरएल बनाएं. इसके लिए, यूआरएल में कोड किए गए जगह के नाम को destination पैरामीटर और जगह के आईडी को destination_place_id पैरामीटर के तौर पर इस्तेमाल करें. Maps के यूआरएल बनाने या इस्तेमाल करने के लिए कोई शुल्क नहीं देना पड़ता. इसलिए, आपको यूआरएल में एपीआई पासकोड शामिल करने की ज़रूरत नहीं है.
https://www.google.com/maps/dir/?api=1&destination=Google%20London&destination_place_id=ChIJVSZzVR8FdkgRTyQkxxLQmVU
आपके पास origin क्वेरी पैरामीटर देने का विकल्प होता है. इसके लिए, डेस्टिनेशन के पते के फ़ॉर्मैट का ही इस्तेमाल करें. हालांकि, इसे शामिल न करने पर, निर्देश उपयोगकर्ता की मौजूदा जगह से शुरू होते हैं. यह जगह, उस जगह से अलग हो सकती है जहां से वे आपके प्रॉडक्ट लोकेटर ऐप्लिकेशन का इस्तेमाल कर रहे थे.
Maps के यूआरएल, क्वेरी पैरामीटर के अन्य विकल्प उपलब्ध कराते हैं. जैसे, नेविगेशन चालू करके निर्देश लॉन्च करने के लिए, travelmode और dir_action=navigate.
क्लिक किए जा सकने वाले इस लिंक में, पिछले उदाहरण के यूआरएल को आगे बढ़ाया गया है. इसमें origin को लंदन के फ़ुटबॉल स्टेडियम के तौर पर सेट किया गया है. साथ ही, मंज़िल तक पहुंचने के लिए, बस, मेट्रो वगैरह के रास्ते के लिए निर्देश देने के लिए, travelmode=transit का इस्तेमाल किया गया है.
इस यूआरएल वाला मैसेज या ईमेल भेजने के लिए, फ़िलहाल हमारा सुझाव है कि आप twilio जैसे किसी तीसरे पक्ष के ऐप्लिकेशन का इस्तेमाल करें. अगर App Engine का इस्तेमाल किया जा रहा है, तो एसएमएस या ईमेल भेजने के लिए, तीसरे पक्ष की कंपनियों का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, तीसरे पक्ष की सेवाओं की मदद से मैसेज भेजना देखें.
इंटरैक्टिव मैप पर अपनी जगहों की जानकारी दिखाना
डाइनैमिक मैप का इस्तेमाल करना
| इस उदाहरण में इनका इस्तेमाल किया गया है: Maps JavaScript API | इनके लिए भी उपलब्ध है: Android | iOS |
लोकेटर, उपयोगकर्ता अनुभव का एक अहम हिस्सा है. हालांकि, कुछ साइटों पर एक सामान्य मैप भी नहीं होता. इस वजह से, उपयोगकर्ताओं को आस-पास की जगह ढूंढने के लिए, साइट या ऐप्लिकेशन को छोड़ना पड़ता है. इसका मतलब है कि उपयोगकर्ताओं को अपनी ज़रूरत की जानकारी पाने के लिए, अलग-अलग पेजों पर जाना पड़ता है. इससे उन्हें खराब अनुभव मिलता है. इसके बजाय, अपने ऐप्लिकेशन में मैप एम्बेड करके और उन्हें अपनी ज़रूरत के मुताबिक बनाकर, इस अनुभव को बेहतर बनाया जा सकता है.
अपने पेज पर डाइनैमिक मैप जोड़ने के लिए, कोड की कुछ लाइनें इस्तेमाल की जा सकती हैं. डाइनैमिक मैप ऐसा मैप होता है जिसे उपयोगकर्ता इधर-उधर ले जा सकते हैं, ज़ूम इन और ज़ूम आउट कर सकते हैं. साथ ही, अलग-अलग जगहों और लोकप्रिय जगहों के बारे में जानकारी पा सकते हैं.
सबसे पहले, आपको पेज में Maps JavaScript API को शामिल करना होगा.
इसके लिए, अपने एचटीएमएल पेज में यह स्क्रिप्ट लिंक करें. इसमें libraries=marker भी शामिल करें, ताकि मैप में ऐडवांस मार्कर जोड़े जा सकें.
<script defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=marker&callback=initMap&solution_channel=GMP_guides_productlocator_v1_a"></script>यूआरएल, JavaScript initMap फ़ंक्शन को रेफ़र करता है. यह फ़ंक्शन, पेज लोड होने पर चलता है. यूआरएल में, अपने मैप की भाषा या क्षेत्र को भी तय किया जा सकता है. इससे यह पक्का किया जा सकता है कि मैप को उस देश के लिए सही तरीके से फ़ॉर्मैट किया गया है जिसे टारगेट किया जा रहा है. कोई क्षेत्र सेट करने से यह भी पक्का होता है कि अमेरिका से बाहर इस्तेमाल किए जाने वाले ऐप्लिकेशन, आपके सेट किए गए क्षेत्र के हिसाब से काम करें. Google Maps Platform की कवरेज की जानकारी देखें. इसमें उन सभी भाषाओं और इलाकों की सूची दी गई है जहां यह सुविधा उपलब्ध है. साथ ही, region पैरामीटर के इस्तेमाल के बारे में ज़्यादा जानें.
इसके बाद, आपको पेज पर अपना मैप दिखाने के लिए, एचटीएमएल div की ज़रूरत होगी.
यह वह जगह है जहां मैप दिखेगा.
<div id="map"></div>अगला चरण, अपने मैप की बुनियादी सुविधाओं को सेट करना है. यह काम, स्क्रिप्ट यूआरएल में बताए गए initMap स्क्रिप्ट फ़ंक्शन में किया जाता है. यहां दिए गए उदाहरण में दिखाई गई इस स्क्रिप्ट में, शुरुआती जगह, मैप आईडी (ऐडवांस मार्कर और क्लाउड पर मैप की स्टाइलिंग की सुविधाओं के लिए ज़रूरी है), मैप का टाइप, और उपयोगकर्ताओं के लिए मैप पर उपलब्ध कंट्रोल सेट किए जा सकते हैं. ध्यान दें कि getElementById(), पिछले "मैप" div आईडी को रेफ़र करता है.
function initMap() { const map = new google.maps.Map(document.getElementById("map"), { zoom: 12, center: { lat: 51.485925, lng: -0.129500 }, mapId: "DEMO_MAP_ID", zoomControl: false }); }
लोकेटर के लिए, आम तौर पर शुरुआती जगह, सेंटर पॉइंट या सीमाएं, और ज़ूम करने का लेवल (मैप को उस जगह पर कितना ज़ूम किया गया है) सेट किया जाता है. ज़्यादातर अन्य एलिमेंट, जैसे कि कंट्रोल को ट्यून करना, ज़रूरी नहीं हैं. ऐसा इसलिए, क्योंकि मैप के साथ इंटरैक्शन का लेवल तय किया जाता है.
अपना मानचित्र कस्टमाइज़ करें
मैप के दिखने के तरीके और उसकी जानकारी में कई तरह से बदलाव किया जा सकता है. उदाहरण के लिए, आपके पास ये काम करने की सुविधा होती है:
- डिफ़ॉल्ट मैप पिन की जगह, अपनी पसंद के मुताबिक मार्कर बनाएं.
- अपने ब्रैंड को दिखाने के लिए, मैप की सुविधाओं के रंग बदलें.
- यह कंट्रोल करें कि आपको कौनसी लोकप्रिय जगहें (घूमने-फिरने की जगहें, रेस्टोरेंट, होटल वगैरह) और कितनी संख्या में दिखानी हैं. इससे आपको अपनी जगहों पर उपयोगकर्ता का ध्यान खींचने में मदद मिलती है. साथ ही, उन लैंडमार्क को हाइलाइट करने में मदद मिलती है जो उपयोगकर्ताओं को सबसे नज़दीकी जगह तक पहुंचने में मदद करते हैं.
ज़रूरत के मुताबिक तैयार मैप मार्कर बनाना
बेहतर मार्कर को अपनी पसंद के मुताबिक बनाया जा सकता है. इसके लिए, डिफ़ॉल्ट पिन के बैकग्राउंड, बॉर्डर या ग्लिफ़ का रंग बदला जा सकता है. उदाहरण के लिए, यह बताने के लिए कि कोई जगह फ़िलहाल खुली है या नहीं. इसके अलावा, मार्कर को कस्टम ग्राफ़िक इमेज से बदला जा सकता है, जैसे कि आपके ब्रैंड का लोगो. साथ ही, कस्टम एचटीएमएल और सीएसएस मार्कर बनाए जा सकते हैं. जानकारी वाली विंडो या पॉप-अप विंडो, उपयोगकर्ताओं को अतिरिक्त जानकारी दे सकती हैं. जैसे, कारोबार के खुले होने का समय, फ़ोन नंबर या फ़ोटो.
यहां एक सैंपल मैप दिया गया है, जिसमें कस्टम ग्राफ़िक मार्कर का इस्तेमाल किया गया है. Maps JavaScript API के कस्टम ग्राफ़िक मार्कर वाले विषय में सोर्स कोड देखें.
ज़्यादा जानकारी के लिए, JavaScript (वेब), Android, और iOS के लिए ऐडवांस मार्कर का दस्तावेज़ देखें.
अपने मैप को शैली ,में ढ़ालें
Google Maps Platform की मदद से, मैप को इस तरह से स्टाइल किया जा सकता है कि उपयोगकर्ता सबसे नज़दीकी जगह ढूंढ सकें और वहां जल्द से जल्द पहुंच सकें. साथ ही, इससे आपको अपने ब्रैंड को मज़बूत बनाने में मदद मिलती है. उदाहरण के लिए, मैप के रंगों को अपनी ब्रैंडिंग के हिसाब से बदला जा सकता है. साथ ही, उपयोगकर्ताओं को दिखने वाली दिलचस्प जगहों को कंट्रोल करके, मैप पर ध्यान भटकाने वाली चीज़ों को कम किया जा सकता है. Google Maps Platform, मैप के लिए कई स्टार्टर टेंप्लेट भी उपलब्ध कराता है. इनमें से कुछ टेंप्लेट, अलग-अलग उद्योगों के लिए ऑप्टिमाइज़ किए गए हैं. जैसे, यात्रा, लॉजिस्टिक्स, रीयल एस्टेट, और खुदरा कारोबार.
अपने प्रोजेक्ट के Google Cloud Console मैप स्टाइल पेज पर, मैप स्टाइल बनाई जा सकती हैं या उनमें बदलाव किया जा सकता है.
Cloud Console में मैप स्टाइल बनाने और स्टाइलिंग करने के ऐनिमेशन देखने के लिए, बड़ा करें:
इंडस्ट्री के हिसाब से मैप स्टाइल
इस ऐनिमेशन में, इंडस्ट्री के हिसाब से पहले से तय की गई मैप स्टाइल दिखाई गई हैं. इनका इस्तेमाल किया जा सकता है. इन स्टाइल से, हर तरह की इंडस्ट्री के लिए सबसे सही शुरुआत की जा सकती है. उदाहरण के लिए, रीटेल मैप स्टाइल, मैप पर लोकप्रिय जगहों की संख्या कम कर देता है. इससे उपयोगकर्ता आपकी जगहों के साथ-साथ लैंडमार्क पर भी फ़ोकस कर पाते हैं. इससे उन्हें सबसे नज़दीकी जगह पर जल्द से जल्द और भरोसे के साथ पहुंचने में मदद मिलती है.
लोकप्रिय जगहों को कंट्रोल करने की सुविधा
इस ऐनिमेशन से, लोकप्रिय जगहों के लिए मार्कर का रंग सेट होता है. साथ ही, मैप स्टाइल में लोकप्रिय जगहों की डेंसिटी बढ़ती है. डेंसिटी जितनी ज़्यादा होगी, मैप पर लोकप्रिय जगहों के उतने ही ज़्यादा मार्कर दिखेंगे.
हर मैप स्टाइल का अपना आईडी होता है. Cloud Console में स्टाइल पब्लिश करने के बाद, अपने कोड में उस मैप आईडी का रेफ़रंस दें. इसका मतलब है कि अपने ऐप्लिकेशन को फिर से रीफ़ैक्टर किए बिना, मैप स्टाइल को रीयल टाइम में अपडेट किया जा सकता है. नया लुक, मौजूदा ऐप्लिकेशन में अपने-आप दिखेगा और इसका इस्तेमाल सभी प्लैटफ़ॉर्म पर किया जाएगा. यहां दिए गए उदाहरणों में, Maps JavaScript API का इस्तेमाल करके किसी वेब पेज पर मैप आईडी जोड़ने का तरीका बताया गया है.
स्क्रिप्ट यूआरएल में एक या उससे ज़्यादा map_ids शामिल करने पर, Maps JavaScript API उन स्टाइल को अपने-आप उपलब्ध करा देता है. इससे, कोड में उन स्टाइल को कॉल करने पर, मैप तेज़ी से रेंडर होता है.
<script
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&map_ids=MAP_IDs&callback=initMap&solution_channel=GMP_guides_productlocator_v1_a">
</script>यहां दिया गया कोड, वेब पेज पर अलग-अलग स्टाइल में मैप दिखाता है. (एचटीएमएल <div id="map"></div> एलिमेंट नहीं दिखाया गया है, जहां पेज पर मैप दिखेगा.)
map = new google.maps.Map(document.getElementById('map'), { center: {lat: 51.485925, lng: -0.129500}, zoom: 12, mapId: '1234abcd5678efgh' });
JavaScript (वेब), Android, और iOS में क्लाउड पर मैप की स्टाइलिंग को शामिल करने के बारे में ज़्यादा जानें.
जगह की जानकारी के डेटा को Place Details के साथ जोड़ना
इंटरैक्टिव मैप पर अपनी जगहों की जानकारी दिखाना सेक्शन में, Place Details का इस्तेमाल करके उपयोगकर्ताओं को आपकी जगहों के बारे में ज़्यादा जानकारी देने का तरीका बताया गया है. जैसे, कारोबार के खुले होने का समय, फ़ोटो, और समीक्षाएं.
Places API (New) में, अलग-अलग डेटा फ़ील्ड की कीमत और एसकेयू टियर को समझना मददगार होता है. लागत को मैनेज करने के लिए, एक रणनीति यह है कि अपनी जगहों के बारे में आपके पास पहले से मौजूद जानकारी को Google Maps से मिली नई जानकारी के साथ जोड़ें. जैसे, कुछ समय के लिए बंद होने की जानकारी, छुट्टियों के दौरान खुले होने का समय, उपयोगकर्ता रेटिंग, फ़ोटो, और समीक्षाएं. अगर आपके पास पहले से ही अपने स्टोर की संपर्क जानकारी है, तो आपको Place Details से उन फ़ील्ड का अनुरोध करने की ज़रूरत नहीं होगी. साथ ही, अपने फ़ील्ड मास्क को सिर्फ़ उन फ़ील्ड को फ़ेच करने के लिए सीमित किया जा सकता है जिन्हें आपको दिखाना है.
ऐसा हो सकता है कि आपके पास जगह की जानकारी का अपना डेटा हो. इसका इस्तेमाल, Place Details के साथ या इसके बजाय किया जा सकता है. फ़ुल-स्टैक लोकेटर के लिए कोड लैब में, डेटाबेस के साथ GeoJSON का इस्तेमाल करने का उदाहरण दिया गया है. इससे, अपनी जगह की जानकारी को सेव और वापस पाया जा सकता है.