लोकेटर प्लस लागू करने के लिए गाइड

खास जानकारी

आपके उपयोगकर्ता, प्रॉडक्ट और सेवाओं के बारे में ऑनलाइन रिसर्च करना चाहते हैं. साथ ही, वहां जाने, अपॉइंटमेंट लेने या ऑर्डर पिक अप करने के लिए सबसे अच्छी और सबसे सुविधाजनक जगह ढूंढना चाहते हैं. वे आपकी जगह पर जल्द से जल्द पहुंचना चाहते हैं और आप उन्हें बेहतर ऑनलाइन अनुभव देना चाहते हैं, ताकि वे आपकी दुकान पर आने वालों की संख्या बढ़ाएं, उन्हें बेहतर अनुभव दे सकें, और सहायता कॉल में कमी ला सकें. आपको लोकेटर की सफलता का आकलन भी करना है, ताकि यह तय किया जा सके कि ग्राहक आपकी जगह की जानकारी ढूंढ सकते हैं या नहीं. साथ ही, आपको यह भी जानना है कि कहां सुधार करने हैं.

Locator Plus, हमने इस विषय में दिशा-निर्देश और पसंद के मुताबिक सलाह देने के बारे में बताया है. हमारा सुझाव है कि Google Maps Platform API का इस्तेमाल बेहतर तरीके से करें, ताकि उपयोगकर्ताओं को लोकेटर का शानदार अनुभव मिल सके. इन तरीकों को अपनाकर, उपयोगकर्ताओं को मैप पर अपनी जगह ढूंढने और फ़ैसला लेने से जुड़ी पूरी जानकारी देखने में मदद की जा सकती है. साथ ही, उन्हें रास्ते की जानकारी भी दी जा सकती है. भले ही, वे गाड़ी चला रहे हों, साइकल चला रहे हों, पैदल चल रहे हों या सार्वजनिक परिवहन से यात्रा कर रहे हों.

Locator Plus के उपयोगकर्ताओं के लिए, Analytics के डैशबोर्ड की मदद से डेटा का विश्लेषण किया जा सकता है और अहम जानकारी जनरेट की जा सकती है. इससे आपको साफ़ तौर पर पता चलता है कि खरीदार, आपके स्टोर लोकेटर के साथ कितनी अच्छी तरह से जुड़ रहे हैं. इस रिपोर्ट को ऐक्सेस करने के लिए, कंसोल के जुड़ाव की रिपोर्ट सेक्शन पर जाएं. इस रिपोर्ट के बारे में ज़्यादा जानकारी के लिए, यूज़र ऐक्टिविटी की रिपोर्ट देखें.

नीचे दिए गए डायग्राम में, लोकेटर प्लस को लागू करने के लिए मुख्य एपीआई दिखाए गए हैं. इस डायग्राम में जगह की जानकारी के डेटा का डेटाबेस भी दिखाया गया है. इस डेटाबेस को जगह की जानकारी के साथ जोड़कर, उपयोगकर्ताओं को सबसे अच्छी और पूरी जानकारी दी जा सकती है. (बड़ा करने के लिए क्लिक करें.)

एपीआई चालू करना

• Maps JavaScript API
• Location API
• जियोकोडिंग एपीआई
• दूरी का मैट्रिक्स एपीआई
• दिशा-निर्देशों के लिए एपीआई

लागू करने के सेक्शन

इस विषय में, नीचे दिए गए तरीके और कस्टमाइज़ेशन के बारे में बात की जाएगी.

• check_circle_filled सही का निशान आइकॉन आम तौर पर इस्तेमाल किया जाता है.
• stars स्टार आइकॉन का इस्तेमाल करना ज़रूरी नहीं है. हालांकि, इसे बेहतर बनाने के लिए, इसे पसंद के मुताबिक बनाने का सुझाव दिया जाता है.

लोकेटर, उपयोगकर्ता अनुभव का एक अहम हिस्सा होता है. हालांकि, कुछ साइटों में सामान्य मैप की कमी हो सकती है, जिसकी वजह से उपयोगकर्ताओं को साइट या ऐप्लिकेशन को छोड़कर जाना पड़ता है, ताकि वे आस-पास की जगह ढूंढ सकें. इसका मतलब है कि यह उन उपयोगकर्ताओं के लिए बेहतर अनुभव नहीं देगा जिन्हें अपनी ज़रूरत की जानकारी पाने के लिए, एक पेज से दूसरे पेज पर जाना पड़ता है. इसके बजाय, मैप को अपने ऐप्लिकेशन में एम्बेड करके और पसंद के मुताबिक बनाकर इस अनुभव को बेहतर बनाया जा सकता है.

इसे चालू करने के कई तरीके हैं: (1) इस सुविधा को बेहतर तरीके से उपलब्ध कराने के लिए, Quick Builder Locator Plus समाधान का इस्तेमाल करना और (2) डाइनैमिक Maps का इस्तेमाल करके, यह सुविधा उपलब्ध कराना. इस सेक्शन में, इन विकल्पों के बारे में पूरी जानकारी दी गई है.

Quick Builder Locator Plus का इस्तेमाल करना

अपनी Business Profile से कारोबार की जानकारी इंपोर्ट करने के लिए, Quick Builder Locator Plus टूल का इस्तेमाल किया जा सकता है. इसलिए, अब आपकी Business Profile में मौजूद कारोबार की जानकारी में किया गया बदलाव, आपकी वेबसाइट के स्टोर लोकेटर में दिखेगा. इन बदलावों में कारोबार के खुले होने का समय, संपर्क जानकारी, फ़ोटो, सेवा के विकल्प वगैरह शामिल हो सकते हैं. क्विक बिल्डर की मदद से, मैप पर कारोबार की जगहें तुरंत सेट अप की जा सकती हैं. साथ ही, डिप्लॉय किया जा सकने वाला कोड जनरेट किया जा सकता है या कुछ ही मिनटों में Google Cloud Storage में सीधे डिप्लॉय किया जा सकता है.

अपने डाइनैमिक मैप लागू करने के तरीके का इस्तेमाल करना

अपने पेज पर डाइनैमिक मैप—यानी, ऐसा मैप जोड़ना जिसे उपयोगकर्ता आसानी से इधर-उधर मूव कर सकें, ज़ूम इन और ज़ूम आउट कर सकें, और अलग-अलग जगहों और लोकप्रिय जगहों के बारे में जानकारी पा सकें—कोड की कुछ लाइनों का इस्तेमाल करके ऐसा किया जा सकता है.

सबसे पहले, आपको पेज में Maps JavaScript API शामिल करना होगा. इसके लिए, नीचे दी गई स्क्रिप्ट को अपने एचटीएमएल पेज से लिंक करें.

<script defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&solution_channel=GMP_guides_locatorplus_v2_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 },
    zoomControl: false
  });
}

लोकेटर के लिए, आपकी दिलचस्पी आम तौर पर शुरुआती जगह, बीच के बिंदु या सीमाओं, और ज़ूम लेवल (उस जगह पर मैप को कितना ज़ूम किया गया है) सेट करने में होती है. मैप के साथ इंटरैक्शन का लेवल तय करने पर, ज़्यादातर एलिमेंट का इस्तेमाल करना ज़रूरी नहीं होता. जैसे, कंट्रोल को ट्यून करना.

जगह के आईडी फ़ेच किए जा रहे हैं

आपके पास जगह की जानकारी का डेटाबेस हो सकता है. इसमें जगह का नाम, उसका पता, और फ़ोन नंबर जैसी बुनियादी जानकारी हो सकती है. Google Maps Platform पर उस जगह की जानकारी पाने के लिए, जिसमें भौगोलिक निर्देशांक और उपयोगकर्ता के योगदान से मिली जानकारी भी शामिल है, अपने डेटाबेस में मौजूद हर जगह से जुड़ा जगह का आईडी ढूंढें. आप Places API जगह खोज में प्लेस एंडपॉइंट ढूंढें पर कॉल कर सकते हैं और सिर्फ़ place_id फ़ील्ड का अनुरोध कर सकते हैं. यहां Google के लंदन ऑफ़िस के लिए जगह के आईडी के अनुरोध का एक उदाहरण दिया गया है:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20london&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_locatorplus_v2_a

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

जगह की जानकारी को जियोकोड करना

अगर जगहों के आपके डेटाबेस में जगहों के पते हैं, लेकिन भौगोलिक निर्देशांक नहीं, तो मैप पर मार्कर को सही जगह पर रखने के लिए, पते के अक्षांश और देशांतर की जानकारी पाने के लिए Geocoding API का इस्तेमाल करें. सर्वर साइड पर अपने पतों को जियोकोड किया जा सकता है, अपने डेटाबेस में अक्षांश और देशांतर को स्टोर किया जा सकता है, और कम से कम हर 30 दिनों में रीफ़्रेश किया जा सकता है.

Google लंदन ऑफ़िस के लिए दिखाए गए जगह के आईडी का अक्षांश और देशांतर पाने के लिए, Geocoding API का इस्तेमाल करने का एक उदाहरण यहां दिया गया है:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJVSZzVR8FdkgRTyQkxxLQmVU&key=YOUR_API_KEY&solution_channel=GMP_guides_locatorplus_v2_a

मैप में स्थान जोड़ना

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

जगह का अक्षांश और देशांतर होने के बाद, मैप में मार्कर जोड़ने का एक उदाहरण यहां दिया गया है:

var marker = new google.maps.Marker({
    position: { lat: 51.493073, lng: -0.146550 },
    label:"A",
    title:"Location Name"
});

// To add the marker to the map, call setMap();
marker.setMap(map);

कुछ मार्कर की मदद से, कई जगहों की जानकारी को एक साथ देखा जा सकता है.

अगर बहुत ज़्यादा जगहें मौजूद हैं, तो JavaScript, Android या iOS के लिए मार्कर क्लस्टरिंग सुविधा का इस्तेमाल किया जा सकता है. JavaScript स्टोर लोकेटर GitHub सैंपल में, मार्कर क्लस्टरिंग का एक उदाहरण यहां दिया गया है.

आपके पास जगह की वह जानकारी शेयर करने का विकल्प होता है जिसके बारे में, उपयोगकर्ताओं को पता होना चाहिए. इसके बाद ही, वे आपकी किसी जगह पर जाएंगे. संपर्क जानकारी, काम के घंटे, उपयोगकर्ता रेटिंग, उपयोगकर्ता की फ़ोटो, और कुछ समय के लिए बंद होने की स्थिति जैसी जगह की बेहतर जानकारी के साथ, आपके उपयोगकर्ताओं को यह पता होगा कि आपके कारोबार की जगह पर आने पर क्या उम्मीद की जानी चाहिए. Places API को कॉल करने के बाद, जवाब को जानकारी विंडो, वेब साइडबार या किसी भी तरीके से फ़िल्टर करके रेंडर किया जा सकता है.

जगह की जानकारी का अनुरोध करने के लिए, आपको अपने हर स्थान के स्थान आईडी की ज़रूरत होगी. अपने कारोबार की जगह का आईडी फिर से पाने के लिए, जगह के आईडी पाना देखें.

नीचे दिए गए उदाहरण में, जगह की जानकारी हासिल करने और उन्हें InfoWindow में जोड़ने के लिए, Places लाइब्रेरी, Maps JavaScript API का इस्तेमाल किया गया है. इसे लागू करने की प्रोसेस में, किसी जगह की जानकारी का अनुरोध करने के लिए, लागत बचाने की रणनीति का इस्तेमाल किया जाता है. इसका इस्तेमाल तब किया जाता है, जब उपयोगकर्ता सभी जगहों की जानकारी को पहले से फ़ेच करने के बजाय, मार्कर पर क्लिक करके जानकारी का अनुरोध करता है.

     
  const marker = new google.maps.Marker({
    map,
    position: { lat: 51.493073, lng: -0.14655 },
  });
  const request = {
    placeId: "ChIJVSZzVR8FdkgRTyQkxxLQmVU",
    fields: ["name", "formatted_address", "rating", "website"],
  };
  const infowindow = new google.maps.InfoWindow();
  const service = new google.maps.places.PlacesService(map);

  google.maps.event.addListener(marker, "click", function () {
    service.getDetails(request, (place, status) => {
      if (status === google.maps.places.PlacesServiceStatus.OK && place) {
        infowindow.setContent(
          "<div><strong>" +
            place.name +
            "</strong><br>" +
            place.formatted_address +
            "<br>" +
            "Rating: " +
            place.rating +
            " stars<br>" +
            place.website +
            "</div>"
        );

        infowindow.open(map, this);
      }
    });
  });
  
  

लोगों को आपकी जगह का एरियल व्यू देने से, उन्हें साफ़ तौर पर पता चलता है कि वह जगह कैसी दिखती है. इससे उन्हें जगह की जानकारी आसानी से खोजने में मदद मिलती है. जब कोई उपयोगकर्ता ज़्यादा जानकारी देखने के लिए किसी एक जगह को चुनता है, तो उस जगह पर ज़ूम इन करके, सैटलाइट से ली गई उपलब्ध तस्वीरें 45° ऐंगल से देखी जा सकती हैं.

नीचे दिया गया कोड सैंपल, मैप को हाई ज़ूम लेवल, इस्तेमाल किए जा सकने वाले मैप टाइप, और झुकाने के ऐंगल पर सेट करता है, ताकि उपलब्ध होने पर 45° की तस्वीरें दिखें. दस्तावेज़ों में 45° की तस्वीरें उपलब्ध होने के बारे में बताया गया है.

function seeDetail(location) {
  map.setCenter(location);
  map.setZoom(19);
  map.setMapTypeId(google.maps.MapTypeId.HYBRID);
  map.setTilt(45);
}

मूल मैप दृश्य पर रीसेट हो रहा है

उपयोगकर्ता अक्सर किसी एक जगह की पूरी जानकारी और आस-पास की कई जगहों की खास जानकारी वाले व्यू के बीच स्विच करना चाहते हैं. यह सुविधा उपलब्ध कराने के लिए, लिसनर जोड़ें, ताकि यह पता लगाया जा सके कि उपयोगकर्ता, पूरी जानकारी वाले व्यू को मैप इंटरैक्शन में या सूची की तरह से देखना कब छोड़ देता है. उदाहरण के लिए, map ऑब्जेक्ट पर zoom_changed इवेंट को सुनने का मतलब है कि उपयोगकर्ता ने या तो पूरी जानकारी वाले व्यू से मैन्युअल तरीके से ज़ूम आउट किया है या किसी अन्य फ़ंक्शन को कॉल किया है जिसने ज़ूम लेवल को अपडेट किया है. इस नमूने में, ज़ूम आउट करने पर मैप मूल मैप टाइप पर रीसेट हो जाता है और झुका रहता है.

let originalMapTypeId = google.maps.MapTypeId.ROADMAP;
map.addListener("zoom_changed", () => {
  const newZoom = map.getZoom()!;

  if (newZoom < 19) {
    map.setTilt(0);
    map.setMapTypeId(originalMapTypeId);
  }
});

किसी भी लोकेटर का अगला मुख्य कॉम्पोनेंट, उपयोगकर्ता की शुरुआती जगह की पहचान करना होता है. ऑरिजिन को उपयोगकर्ता की मौजूदा जगह के तौर पर सेट करने के लिए, डिफ़ॉल्ट रूप से उपयोगकर्ता की अनुमतियों का अनुरोध करने के लिए, मोबाइल लोकेशन सेवाओं और वेब ब्राउज़र के जियोलोकेशन का इस्तेमाल किया जा सकता है. हालांकि, हो सकता है कि उपयोगकर्ता उन अनुमतियों को अस्वीकार कर दे या अपनी शुरुआत की जगह के तौर पर कोई दूसरी जगह सेट करना चाहे.

आज-कल के उपयोगकर्ता, Google Maps के 'उपभोक्ता वर्शन' पर, ऑटोकंप्लीट टाइप-अहेड फ़ंक्शन की सुविधा के आदत डाल चुके हैं. इस सुविधा को मोबाइल डिवाइस और वेब पर Google Maps Platform Places की लाइब्रेरी का इस्तेमाल करके किसी भी ऐप्लिकेशन में इंटिग्रेट किया जा सकता है. जब कोई उपयोगकर्ता पता टाइप करता है, तो विजेट का इस्तेमाल करके वह पता अपने-आप भर जाता है. सीधे तौर पर Places लाइब्रेरी का इस्तेमाल करके, अपने-आप पूरा होने वाला फ़ंक्शन भी दिया जा सकता है.

अपनी साइट में 'जगह के हिसाब से ऑटोकंप्लीट' लाइब्रेरी जोड़ना, Maps JavaScript API के स्क्रिप्ट यूआरएल में क्वेरी पैरामीटर जोड़ने का तरीका है. इस उदाहरण में, जोड़ा गया libraries=places है.

<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places&callback=initMap&solution_channel=GMP_guides_locatorplus_v2_a" defer></script>

इसके बाद, उपयोगकर्ता के इनपुट के लिए अपने पेज पर एक टेक्स्ट बॉक्स जोड़ें.

<input id="autocomplete" placeholder="Enter starting
      address, city, or zip code" type="text"></input>

अंत में, आपको ऑटोकंप्लीट सेवा शुरू करनी होगी और इसे नाम वाले टेक्स्ट बॉक्स से लिंक करना होगा. जियोकोड के टाइप के लिए ऑटोकंप्लीट सुविधा की मदद से मिलने वाले सुझावों को रोकें. इससे आपका इनपुट फ़ील्ड, मोहल्ले के पते, आस-पास के इलाकों, शहरों, और पिन कोड को स्वीकार करने के लिए कॉन्फ़िगर हो जाता है. इससे उपयोगकर्ता अपने ऑरिजिन के बारे में बताने के लिए, किसी भी तरह की खास जानकारी डाल सकते हैं. geometry फ़ील्ड के लिए अनुरोध ज़रूर करें, ताकि जवाब में उपयोगकर्ता के ऑरिजिन का अक्षांश और देशांतर शामिल हो. इन मैप कोऑर्डिनेट का इस्तेमाल, मैप को फिर से बीच में लाने के लिए किया जा सकता है. साथ ही, इन निर्देशांकों का इस्तेमाल आपकी जगहों और इनका ऑरिजिन से संबंध बताने के लिए भी किया जा सकता है.

  // Create the autocomplete object, restricting the search predictions to
  // geographical location types.
  const autocomplete = new google.maps.places.Autocomplete(
    document.getElementById("autocomplete"),
    { types: ["geocode"],
      componentRestrictions: {'country': ['gb']},
      fields: ['place_id', 'geometry', 'formatted_address'] }
  );
  // When the user selects an address from the drop-down
  // zoom to the select location and add a marker.
  autocomplete.addListener("place_changed", addUserLocation);
}

इस उदाहरण में, उपयोगकर्ता के पता चुनने के बाद, addUserLocation() फ़ंक्शन लागू होता है. यह मेल खाने वाले नतीजे की ज्यामिति, यानी उपयोगकर्ता की जगह की जानकारी लेता है, फिर मैप को उस जगह पर ले जाता है और एक मार्कर जोड़ देता है.

function addUserLocation() {
  // Get the place details from the autocomplete object.
  const place = autocomplete.getPlace();

  // Add a marker to the map.
  const marker = new google.maps.Marker({
          map: map
        });

  marker.setLabel("C");
  marker.setPosition(place.geometry.location);

  // Zoom the map to the marker.
  map.panTo(place.geometry.location);
  map.setZoom(12);
}

इसके बाद, आप उपयोगकर्ता के साथ किसी खास जगह के संबंध को देख सकते हैं, जैसा कि नीचे दी गई इमेज में दिखाया गया है.

उपयोगकर्ता की जगह की जानकारी मिलने के बाद, उसकी तुलना अपनी जगह की जानकारी से की जा सकती है. दूरी मैट्रिक्स सेवा की मदद से ऐसा करने पर, Maps JavaScript API, आपके उपयोगकर्ताओं को उनकी सुविधा के हिसाब से जगह चुनने में मदद करता है. इसके लिए, ड्राइविंग में लगने वाला समय या सड़क की दूरी तय की जाती है.

किसी उपयोगकर्ता के आस-पास की जगहों की जानकारी दिखाने का मतलब है कि आपने जगहों की जानकारी पहले से भरी हुई है. जगह की जानकारी वाले अपने डेटाबेस का इस्तेमाल करते समय, यह पक्का करना ज़रूरी होता है कि डेटा ऐसे फ़ॉर्मैट में हो जिसे मैप में इस्तेमाल किया जा सके, जैसे कि GeoJSON के बारे में जिसकी जानकारी डेटा लेयर में दी गई है.

जगहों की सूची को व्यवस्थित करने का स्टैंडर्ड तरीका है, दूरी के हिसाब से उन्हें क्रम में लगाना. अक्सर इस दूरी का हिसाब, उपयोगकर्ता से उस जगह तक जाने के लिए एक सीधी लाइन का इस्तेमाल करके लगाया जाता है. हालांकि, यह दूरी गुमराह करने वाली हो सकती है. सीधी लाइन, किसी ऐसी नदी के ऊपर हो सकती है जिसे पार नहीं किया जा सकता या फिर भीड़-भाड़ वाली सड़कों से होकर. ऐसा तब होता है, जब कोई दूसरी जगह ज़्यादा सुविधाजनक हो. ऐसा करना तब अहम होता है, जब आपके कारोबार की कई जगहें एक-दूसरे से कुछ किलोमीटर के दायरे में मौजूद हों.

डिस्टेंस मैट्रिक्स सेवा, यात्रा की शुरुआत करने की जगह और मंज़िल की जगहों की सूची लेकर काम करती है. यह सेवा न सिर्फ़ यात्रा की दूरी, बल्कि उनके बीच के समय की जानकारी भी देती है. उपयोगकर्ता के मामले में, शुरुआत की जगह वह जगह होगी जहां वह अभी मौजूद है या वह जगह जहां से यात्रा शुरू करनी है. वहीं, डेस्टिनेशन उन जगहों में से होगी. शुरुआत की जगह और डेस्टिनेशन को कोऑर्डिनेट पेयर या पतों के तौर पर बताया जा सकता है; बाद वाले को सेवा को कॉल किए जाने पर मैच किया जाएगा. ड्राइविंग के मौजूदा या आने वाले समय के आधार पर नतीजे दिखाने के लिए, कई अतिरिक्त पैरामीटर के साथ दूरी का मैट्रिक्स इस्तेमाल किया जा सकता है.

यहां दिए गए उदाहरण में, दूरी का मैट्रिक्स बताने वाली सेवा को कॉल किया गया है. इसमें उपयोगकर्ता की जगह और उसके ऑरिजिन के बारे में बताया गया है. इस उदाहरण में लंदन में, मैप सेंटर से Google के तीन ऑफ़िस की दूरी दिखाई गई है.

यूआरएल को कोड में बदलने का क्विक रेफ़रंस: %2C = , (कॉमा), %3A = : (कोलन), और %7C = | (पाइप).

      https://maps.googleapis.com/maps/api/distancematrix/json?origins=51.493490%2C-0.097288
      &destinations=place_id%3AChIJVSZzVR8FdkgRTyQkxxLQmVU%7Cplace_id%3AChIJVSZzVR8FdkgR-HklrBMO0Hc%7Cplace_id%3AChIJ4abvVDwbdkgRDZVFR7A6Bcc
      &units=metric
      &mode=driving
      &key=YOUR_API_KEY
      &solution_channel=GMP_guides_locatorplus_v2_a

यहां दिया गया वर्शन दिया गया है जिसे कॉपी करके चलाया जा सकता है:

      https://maps.googleapis.com/maps/api/distancematrix/json?key=YOUR_API_KEY&origins=51.493490%2C-0.097288&destinations=place_id%3AChIJVSZzVR8FdkgRTyQkxxLQmVU%7Cplace_id%3AChIJVSZzVR8FdkgR-HklrBMO0Hc%7Cplace_id%3AChIJ4abvVDwbdkgRDZVFR7A6Bcc&units=metric&mode=driving&solution_channel=GMP_guides_locatorplus_v2_a

सेवा से मिलने वाला असल जवाब, मैच होने वाले पतों, दूरी, और कुल समय की एक सूची होगी. इसके बारे में, इस उदाहरण में बताया गया है:

{
    "destination_addresses": [
        "123 Buckingham Palace Rd, Victoria, London SW1W 9SH, UK",
        "1-13 St Giles High St, West End, London WC2H 8AG, UK",
        "6 Pancras Square, Kings Cross, London N1C 4AG, UK"
    ],
    "origin_addresses": [
        "Unnamed Road, London, UK"
    ],
    "rows": [
        {
            "elements": [
                {
                    "distance": {
                        "text": "4.5 km",
                        "value": 4540
                    },
                    "duration": {
                        "text": "15 mins",
                        "value": 924
                    },
                    "status": "OK"
                },
                {
                    "distance": {
                        "text": "5.0 km",
                        "value": 5043
                    },
                    "duration": {
                        "text": "17 mins",
                        "value": 1044
                    },
                    "status": "OK"
                },
                {
                    "distance": {
                        "text": "6.9 km",
                        "value": 6919
                    },
                    "duration": {
                        "text": "23 mins",
                        "value": 1357
                    },
                    "status": "OK"
                }
            ]
        }
    ],
    "status": "OK"
}

नीचे दी गई इमेज में, मैप पर शुरुआत की जगह (रेड मार्कर C) और मंज़िलों को दिखाया गया है:

सीधी लाइन की दूरी और रास्ते की दूरी में अक्सर अंतर होता है, जैसा कि इस टेबल में दिखाया गया है.

दूरी के हिसाब से, जगह B सबसे नज़दीकी है, लेकिन वहां पहुंचने का रास्ता और समय काफ़ी ज़्यादा है, क्योंकि जगह A हाइवे से भी जा सकती है.

यह अनुरोध करने के बाद, आप मिलान को प्रोसेस कर सकते हैं, ताकि ड्राइविंग में लगने वाले कुल समय के हिसाब से जवाबों को क्रम से लगाया जा सके. आपको लोकेटर कोडलैब में, ऐसे फ़ंक्शन के उदाहरण मिल सकते हैं.

उपयोगकर्ताओं को अपनी साइट या ऐप्लिकेशन में से दिशा-निर्देश दिखाने का मतलब है कि उन्हें आपकी साइट से किसी दूसरी साइट पर जाने की ज़रूरत नहीं होगी. इसका मतलब है कि उपयोगकर्ताओं का ध्यान अन्य पेजों की ओर नहीं जाएगा और न ही उन्हें मैप पर प्रतिस्पर्धी दिखेंगे. किसी खास यात्रा के मोड से होने वाले कार्बन उत्सर्जन को भी दिखाया जा सकता है. साथ ही, यह भी दिखाया जा सकता है कि किसी खास यात्रा से कितना कार्बन उत्सर्जन हुआ है.

रास्ते की जानकारी देने वाली सेवा में ऐसे फ़ंक्शन भी होते हैं जिनकी मदद से आप नतीजों को प्रोसेस कर सकते हैं और उन्हें मैप पर आसानी से दिखा सकते हैं.

नीचे दिशा-निर्देश पैनल को दिखाने का एक उदाहरण दिया गया है. सैंपल के बारे में ज़्यादा जानकारी के लिए, टेक्स्ट वाले निर्देश दिखाना देखें.

Maps की इन सुविधाओं के बारे में ज़्यादा जानने के लिए, Maps JavaScript API से जुड़े दस्तावेज़ पढ़ें या लोकेटर बनाने के लिए सिलसिलेवार तरीके से दिए गए कोडलैब देखें.

जब लोग साइड पैनल में आपकी जगह की जानकारी वाली जगह की जानकारी देखते हैं, तो बटन पर क्लिक करके अपॉइंटमेंट बुक करने की सुविधा दी जा सकती है. इस इमेज का उदाहरण यहां दिया गया है.

इसे चालू करने के कई तरीके हैं: (1) इस सुविधा को बेहतर बनाने के लिए, Quick Builder Locator Plus समाधान का इस्तेमाल करके और (2) अपनी Business Profile का इस्तेमाल करना. इस सेक्शन में, इन विकल्पों के बारे में पूरी जानकारी दी गई है.

Quick Builder Locator Plus का इस्तेमाल करना

अपनी Business Profile से कारोबार की जानकारी आसानी से इंपोर्ट करने के लिए, Quick Builder Locator Plus टूल का इस्तेमाल किया जा सकता है. क्विक बिल्डर टूल में इंपोर्ट किए जाने के बाद, Reserve with Google की मदद से, अपने कारोबार की जगहों के लिए एम्बेड किए गए अपॉइंटमेंट बुकिंग लिंक को चालू किया जा सकता है. हालांकि, ऐसा सिर्फ़ उन लिंक के लिए होगा जो उपलब्ध हों. अगर आपके पास Google खाते से जुड़ी Business Profile नहीं है, तब भी Quick Builder का इस्तेमाल करके उन कारोबारों के लिए बुकिंग लिंक जोड़े जा सकते हैं जिन्हें आपने Reserve with Google* की मदद से, तीसरे पक्ष की बुकिंग की सेवा देने वाली कंपनियों के साथ पहले से चालू किया हुआ है.

*Google से रिज़र्व सिर्फ़ कुछ देशों/इलाकों में उपलब्ध है, जहां कारोबार इस सुविधा के साथ काम करने वाली बुकिंग की सेवा देने वाली कंपनी के साथ काम करते हैं. अगर आपकी दिलचस्पी Reserve with Google में है, लेकिन अभी आप Reserve with Google पार्टनर के साथ काम नहीं कर रहे हैं, तो कृपया अपनी सेवा देने वाली कंपनी को यह फ़ॉर्म भरकर अपनी दिलचस्पी सबमिट करने के लिए कहें. साथ ही, कंपनी शुरू करने का तरीका जानने के लिए, हमारे दस्तावेज़ पढ़ें. अगर आपने पहले से बुकिंग की सेवा देने वाली किसी कंपनी के साथ काम नहीं किया है, तो Business Profile मैनेज करने के डैशबोर्ड के बुकिंग सेक्शन में, ज़रूरी शर्तें पूरी करने वाली कंपनियों की जानकारी देखी जा सकती है.

अपॉइंटमेंट बुकिंग की सुविधा चालू करने के लिए, Business Profile का इस्तेमाल किया जा रहा है

Business Profile की मदद से इंटरनेट पर मौजूदगी को मैनेज करने पर, कारोबार की वे जगहें Google Maps Platform के जगह के आईडी से जुड़ी होती हैं. इससे कारोबार के डेटा के साथ मैपिंग की सुविधा को चालू किया जा सकता है.

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

जब उपयोगकर्ता साइड पैनल में आपकी किसी जगह की जानकारी देखते हैं, तो आप उन्हें अपॉइंटमेंट लेने के लिए लिंक दे सकते हैं. इस सेक्शन में इसका तरीका बताया गया है.

1. APPOINTMENT, ONLINE_APPOINTMENT या DINING_RESERVATION टाइप की जगह के लिए, Business Profile का एपीआई placeActionLink बनाएं. साइड पैनल में, अपॉइंटमेंट के लिंक के लिए इस्तेमाल किया जाने वाला ऑब्जेक्ट placeActionLink होगा. (अगर आपने अपनी पसंद का अपॉइंटमेंट लिंक पहले ही बना लिया है, तो सीधे अगले चरण पर जाएं.) placeActionLinks.create पीओएसटी तरीके से हुई सही कार्रवाई से मिलने वाले रिस्पॉन्स का उदाहरण यहां दिया गया है:

   {
       "name": "locations/15899957830169237700/placeActionLinks/9c984be778a7ebbc",
       "providerType": "MERCHANT",
       "isEditable": true,
       "uri": "https://example.com/reservation-uri",
       "placeActionType": "DINING_RESERVATION",
       "createTime": "2021-05-01T01:17:41.609161Z",
       "updateTime": "2021-05-01T01:17:41.609161Z"
   }
   

2. Google Maps Platform पर जगह के आईडी से जुड़ी Business Profile की जगह की जानकारी ढूंढें.

   जब उपयोगकर्ता किसी जगह की जानकारी देखते हैं, तो वे Google Maps Platform के जगह के आईडी की जानकारी देखते हैं. जगह का आईडी, Business Profile के लोकेशन आईडी से जुड़ा होता है. इसलिए, आपको मैप जगह के आईडी के आधार पर जगह का आईडी ढूंढना होगा, ताकि आपने जो लिंक बनाया हो उसे वापस लाया जा सके और दिखाया जा सके. Business Profile के इन एपीआई के लिए कॉल करें:

   1. अपने प्रोजेक्ट के खातों की सूची बनाएं.
   2. खाते में मौजूद सभी जगहों की जानकारी दें.
   3. खाते की जगहों में, LocationKey में Google Maps Platform का जगह का आईडी होता है. इसकी तुलना, देखी जा रही जगह के जगह के आईडी से की जा सकती है.

3. लोकेशन आईडी से आपको कार्रवाई का लिंक मिल सकता है. किसी मौजूदा अपॉइंटमेंट placeActionLink को फिर से पाने के लिए, जगह के लिए मौजूदा placeActionLinks की सूची बनाएं. इसके बाद, placeActionType को फ़िल्टर करके वह अपॉइंटमेंट लिंक ढूंढें जिसका आपको इस्तेमाल करना है (APPOINTMENT,ONLINE_APPOINTMENT या DINING_RESERVATION).

   यहां दिए गए उदाहरण में, 'सूची' कॉल के रिस्पॉन्स में, अपॉइंटमेंट placeActionLink दिखाया गया है.

    {
      "placeActionLinks": [
          {
              "name": "locations/15899957830169237700/placeActionLinks/9c984be778a7ebbc",
              "providerType": "MERCHANT",
              "isEditable": true,
              "uri": "https://example.com/",
              "placeActionType": "APPOINTMENT",
              "createTime": "2021-05-01T01:17:41.609161Z",
              "updateTime": "2021-05-01T01:17:41.609161Z"
          }
      ]
    }

4. साइड पैनल में <div> बनाएं और उसमें placeActionLink ऑब्जेक्ट से मिले काम के डेटा का इस्तेमाल करें. खास तौर पर, अपॉइंटमेंट के बुकिंग लिंक के लिए यूआरआई.

अपॉइंटमेंट के लिंक जोड़ने के अन्य विकल्प

अगर आपके पास Business Profile को मैनेज करने का अधिकार नहीं है या आपको Quick Builder Locator Plus सलूशन का इस्तेमाल नहीं करना है, तो किसी वेबसाइट या ऐप्लिकेशन में बुकिंग विजेट को एम्बेड करने से जुड़े दस्तावेज़ देखने के लिए, अपॉइंटमेंट बुक करने वाले प्लैटफ़ॉर्म पर जाएं. Google Cloud का भी इस्तेमाल किया जा सकता है. जैसे, इन्वेंट्री मैनेजमेंट के लिए Cloud Spanner (वीडियो).

किसी जगह के लिए, जगह की जानकारी वाले साइड पैनल में, उपयोगकर्ताओं को क्लिक करने के लिए स्थानीय ऑफ़र दिखाए जा सकते हैं. Google My Business API का इस्तेमाल करके, आप अपनी जगहों से जुड़ी "पोस्ट" (जैसे कि स्थानीय ऑफ़र) बना सकते हैं और उन्हें वापस पा सकते हैं. यहां दिए गए डायग्राम में, जगह की जानकारी वाले साइड पैनल में स्थानीय ऑफ़र का उदाहरण दिखाया गया है.

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

लोकल ऑफ़र, जगहों से जुड़े होते हैं. इसलिए, आपको Business Profile का लोकेशन आईडी ढूंढना होगा. यह उस जगह के लिए Google Maps Platform का प्लेस आईडी होना चाहिए जिसे लोग देख रहे हैं. Business Profile का जगह की जानकारी का आईडी होने पर, आपके पास उससे जुड़े ऑफ़र को localPost के तौर पर वापस पाने का विकल्प होता है. ऐसा, जगह की जानकारी वाले साइड पैनल में करने के लिए किया जाता है. इसका तरीका यहां बताया गया है:

1. Google My Business API की मदद से, ऐसी कोई भी ऑफ़र पोस्ट बनाएं जिसे आपको OFFER तरह का दिखाना है.

2. मैप पर, जगह के आईडी से जुड़ी Business Profile की जगह की जानकारी / जगह का आईडी देखें.

   जब उपयोगकर्ता किसी जगह की जानकारी देखते हैं, तो वे Google Maps Platform के किसी जगह के आईडी की जानकारी देखते हैं. जगह का आईडी, Business Profile के लोकेशन आईडी से जुड़ा होता है. इसलिए, आपको मैप पर जगह के आईडी से जगह का आईडी खोजना होगा, ताकि आपकी जगह से जुड़े स्थानीय ऑफ़र का लिंक वापस लाया जा सके और उसे दिखाया जा सके. Business Profile के इन एपीआई के लिए कॉल करें:

   1. अपने प्रोजेक्ट के खातों की सूची बनाएं.
   2. किसी खाते में मौजूद सभी जगहों की सूची बनाएं.
   3. खाते की जगहों में, LocationKey में मैप का जगह का आईडी होता है. इसकी तुलना, देखी जा रही जगह के जगह के आईडी से की जा सकती है.

   Business Profile के एपीआई में, किसी जगह की जानकारी के लिए किए गए अनुरोध का एक उदाहरण नीचे दिया गया है:

   https://mybusiness.googleapis.com/v4/accounts/111098884960588804666/locations/15899957830169237700

   इस जवाब में एक locationKey फ़ील्ड होता है, जो कि जगह का आईडी होता है. इसका इस्तेमाल Google Maps Platform के अनुरोधों के लिए किया जा सकता है.

   जवाब का सैंपल देखने के लिए बड़ा करें.

         {
       "name": "accounts/111098884960588804666/locations/15899957830169237700",
       "locationName": "Sushi Sushi",
       "primaryPhone": "+49 2222 22222",
       "primaryCategory": {
           "displayName": "Restaurant",
           "categoryId": "gcid:restaurant",
       },
       "regularHours": {
           "periods": [
               {
                   "openDay": "MONDAY",
                   "openTime": "09:00",
                   "closeDay": "MONDAY",
                   "closeTime": "09:10"
               },
               {
                   "openDay": "TUESDAY",
                   "openTime": "11:30",
                   "closeDay": "TUESDAY",
                   "closeTime": "24:00"
               }
           ]
       },
       "locationKey": {
           "placeId": "ChIJs4wtL04X2jERbc8qHd_wZzk",
           "requestId": "2c72cbcb-ea2e-4d66-b684-0ef5f090300c"
       },
       "latlng": {
           "latitude": 1.3670033,
           "longitude": 103.8556385
       },
       "openInfo": {
           "status": "OPEN",
           "canReopen": true
       },
       "locationState": {
           "isGoogleUpdated": true,
           "canUpdate": true,
           "canDelete": true,
           "isVerified": true,
           "isPublished": true,
           "canHaveFoodMenus": true
       },
       "attributes": [
           {
               "attributeId": "has_delivery",
               "valueType": "BOOL",
               "values": [
                   false
               ]
           },
           {
               "attributeId": "requires_masks_customers",
               "valueType": "BOOL",
               "values": [
                   true
               ]
           },
           {
               "attributeId": "url_order_ahead",
               "valueType": "URL",
               "urlValues": [
                   {
                       "url": "https://example.com/"
                   },
               ]
           },
           {
               "attributeId": "pay_credit_card_types_accepted",
               "valueType": "REPEATED_ENUM",
               "repeatedEnumValue": {
                   "setValues": [
                       "visa"
                   ],
                   "unsetValues": [
                       "american_express"
                   ]
               }
           }
       ],
       "address": {
           "regionCode": "SG",
           "languageCode": "en-US",
           "postalCode": "560445",
           "addressLines": [
               "445 Ang Mo Kio Ave 10"
           ]
       },
       "profile": {
           "description": "Example restaurant"
       }
   }
         

3. अब आपके पास जगह की जानकारी का आईडी है, तो आपको मनचाहा ऑफ़र मिल सकता है. किसी मौजूदा ऑफ़र की पोस्ट फिर से पाने के लिए, जगह के लिए मौजूदा localPosts की सूची बनाएं. साथ ही, ऑफ़र से जुड़ा जिस कॉन्टेंट का इस्तेमाल करना है उसे ढूंढने के लिए OFFER में से topicType का फ़िल्टर लगाएं.

   किसी जगह के लिए चालू स्थानीय पोस्ट की सूची बनाने के अनुरोध का एक उदाहरण यहां दिया गया है:

   https://mybusiness.googleapis.com/v4/accounts/111098884960588804666/locations/15899957830169237700/localPosts

   इस उदाहरण में, जवाब में OFFER localPost दिखाया गया है.

   जवाब का सैंपल देखने के लिए बड़ा करें.

   {
       "localPosts": [
           {
               "name": "accounts/111098884960588804666/locations/15899957830169237700/localPosts/2524928563578730680",
               "languageCode": "en",
               "summary": "Buy One Get One Free on all order-ahead bento boxes today!",
               "state": "LIVE",
               "event": {
                   "title": "Bento BOGO",
                   "schedule": {
                       "startDate": {
                           "year": 2020,
                           "month": 1,
                           "day": 20
                       },
                       "startTime": {},
                       "endDate": {
                           "year": 2021,
                           "month": 1,
                           "day": 21
                       },
                       "endTime": {}
                   }
               },
               "updateTime": "2020-09-11T10:56:22.594Z",
               "createTime": "2020-09-11T10:56:22.594Z",
               "searchUrl": "https://local.google.com/place?id=4156539623820808045&use=posts&lpsid=2524928563578730680",
               "media": [
                   {
                       "name": "accounts/111098884960588804666/locations/15899957830169237700/media/localPosts/AF1QipOBQCIf40SbF_PPJxb_zvfCHmaTbv9Zw02PoYPS",
                       "mediaFormat": "PHOTO",
                       "googleUrl": "https://lh3.googleusercontent.com/p/AF1QipOBQCIf40SbF_PPJxb_zvfCHmaTbv9Zw02PoYPS"
                   }
               ],
               "topicType": "OFFER",
               "offer": {
                   "couponCode": "BOGO-JET-CODE",
                   "redeemOnlineUrl": "https://www.example.com/redeem",
                   "termsConditions": "Offer only valid for order-ahead orders placed online."
               }
           },
       ],
   }
           

4. साइड पैनल में localPost ऑब्जेक्ट से मिले काम के डेटा का इस्तेमाल करके, <div> बनाएं और उसे अपने-आप भरें.

आप अपने मैप के रंग-रूप और उसकी जानकारी को कई तरीकों से बदल सकते हैं. उदाहरण के लिए, आपके पास ये काम करने की सुविधा होती है:

• डिफ़ॉल्ट मैप पिन बदलने के लिए अपने स्वयं के कस्टम मार्कर बनाएं.
• अपने ब्रांड को दर्शाने के लिए मैप की सुविधाओं का रंग बदलें.
• यह कंट्रोल करें कि आपको कौनसी जगहें (घूमने-फिरने की जगहें, खाना, ठहरने की जगहें वगैरह) दिखानी हैं और किस जगह पर. इससे, उन जगहों को हाइलाइट किया जा सकता है जो उपयोगकर्ताओं को सबसे नज़दीकी जगह पर पहुंचने में आपकी मदद करती हैं.

कस्टम मैप मार्कर बनाना

आप डिफ़ॉल्ट रंग बदलकर (यह दिखा सकते हैं कि कोई जगह फ़िलहाल खुली है या नहीं) या मार्कर की जगह कोई कस्टम इमेज, जैसे कि अपने ब्रैंड का लोगो लगाकर अपने मार्कर को पसंद के मुताबिक बनाया जा सकता है. जानकारी विंडो या पॉप-अप विंडो से उपयोगकर्ताओं को ज़्यादा जानकारी मिल सकती है. जैसे, कारोबार के खुले होने का समय, फ़ोन नंबर या फ़ोटो. ऐसे कस्टम मार्कर भी बनाए जा सकते हैं जो रास्टर, वेक्टर, खींचने और छोड़ने लायक, और यहां तक कि ऐनिमेशन भी हों.

नीचे एक नमूना मैप दिया गया है, जिसमें कस्टम मार्कर का इस्तेमाल किया गया है. ( Maps JavaScript API कस्टम मार्कर विषय में सोर्स कोड देखें.)

ज़्यादा जानकारी के लिए, JavaScript (वेब), Android, और iOS के लिए मार्कर दस्तावेज़ देखें.

अपने मैप का लुक तय करना

Google Maps Platform आपको अपने मैप को इस तरह से शैली में ढालने की सुविधा देता है कि उपयोगकर्ता सबसे नज़दीकी जगह ढूंढ सकें, जल्द से जल्द वहां पहुंच सकें, और आपके ब्रैंड को और ज़्यादा बढ़ा सकें. उदाहरण के लिए, अपनी ब्रैंडिंग के हिसाब से मैप के रंग बदले जा सकते हैं. साथ ही, उपयोगकर्ताओं को दिखने वाली लोकप्रिय जगहों को कंट्रोल करके, मैप पर ध्यान भटकाने वाली चीज़ों को कम किया जा सकता है. Google Maps Platform कई मैप स्टार्टर टेंप्लेट भी उपलब्ध कराता है. इनमें से कुछ को अलग-अलग उद्योगों, जैसे कि यात्रा, लॉजिस्टिक, रीयल एस्टेट, और रीटेल के लिए ऑप्टिमाइज़ किया जाता है.

Google Cloud Console में, अपने प्रोजेक्ट के मैप स्टाइल पेज में मैप स्टाइल बनाए जा सकते हैं या उनमें बदलाव किया जा सकता है.

Cloud Console में मैप स्टाइल बनाने और स्टाइल करने के ऐनिमेशन देखने के लिए बड़ा करें:

इंडस्ट्री मैप स्टाइल

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

लोकप्रिय जगहों को कंट्रोल करने की सुविधा

यह ऐनिमेशन, लोकप्रिय जगहों के लिए मार्कर का रंग सेट करता है और मैप की स्टाइल में POI को बढ़ा देता है. सघनता जितनी ज़्यादा होगी, मैप पर लोकप्रिय जगह के मार्कर उतने ही ज़्यादा दिखेंगे.

हर मैप स्टाइल का अपना आईडी होता है. 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_locatorplus_v2_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 में क्लाउड-आधारित मैप स्टाइलिंग को शामिल करने के बारे में ज़्यादा जानें.

आंकड़ों का इस्तेमाल करके, आपको इस बारे में अहम जानकारी मिल सकती है कि उपयोगकर्ता आपके लोकेटर के साथ कैसे इंटरैक्ट कर रहे हैं. इस सेक्शन में, Google Analytics और Business Profile के आंकड़ों को कॉन्फ़िगर करने और उन्हें मॉनिटर करने के बारे में बताया गया है, ताकि आपकी दिलचस्पी के डेटा को ट्रैक किया जा सके. Quick Builder Plus का इस्तेमाल करने वाले लोगों के लिए, Analytics के डैशबोर्ड की मदद से अहम जानकारी का विश्लेषण किया जा सकता है और उसे जनरेट किया जा सकता है. इससे आपको यह पता चलता है कि आपकी साइट पर आने वाले लोग, स्टोर लोकेटर के साथ कितनी अच्छी तरह से इंटरैक्ट कर रहे हैं. यह जानकारी, पहचान छिपाकर रखे गए डेटा के आधार पर मिलती है.

इस रिपोर्ट को ऐक्सेस करने के लिए, Cloud Console के यूज़र ऐक्टिविटी की रिपोर्ट सेक्शन पर जाएं. इस रिपोर्ट के बारे में ज़्यादा जानकारी के लिए, यूज़र ऐक्टिविटी की रिपोर्ट देखें.

Google Analytics की क्षमता और ज़रूरत के हिसाब से, हम सेटअप और इस्तेमाल के बारे में पूरी जानकारी देने की कोशिश नहीं करेंगे. इसके बजाय, हम आपके लोकेटर ऐप्लिकेशन के आंकड़ों से जुड़ी ज़रूरी बातों को हाइलाइट करते हुए, आपको आगे पढ़ने और निर्देशों के लिए ज़रूरी दस्तावेज़ देंगे.

Google Analytics सेट अप करना

अगर आप अपने ऐप्लिकेशन के साथ पहले से Google Analytics का इस्तेमाल कर रहे हैं, तो आप इस सेक्शन को छोड़ सकते हैं.

नीचे "ग्लोबल टैग" का एक उदाहरण दिया गया है, जिसे Google Analytics को चालू करने के लिए अपनी साइट पर चिपकाएं.

<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/
gtag/js?id=G-XR5B5D4NW0"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'G-XR5B5D4NW0');
</script>

चाहे आप Google Tag Manager का इस्तेमाल कर रहे हों या Google Analytics को सीधे अपनी साइट में जोड़ रहे हों, इन कामों को करने के लिए, Google Analytics को लागू करने के तरीके को समझना सबसे ज़रूरी है:

• इससे उपयोगकर्ता के इंटरैक्शन ट्रिगर होते हैं, जैसे कि क्लिक. इन्हें वेबसाइट के पेज व्यू (इवेंट) से अलग मेज़र किया जा सकता है.
• काम के ग्रुप (डाइमेंशन या कस्टम डाइमेंशन) में रॉ डेटा (metrics) देखें.

कस्टम इवेंट का इस्तेमाल करना

यहां अपने लोकेटर में कस्टम इवेंट तय करने का एक उदाहरण दिया गया है:

gtag('event', 'location', {
  'method': 'address'
});

अपने event और method को साफ़ तौर पर इतना नाम देना ज़रूरी है कि आप रिपोर्टिंग में इवेंट को समझ सकें. उन्हें उन खास इंटरैक्शन के लिए ट्रिगर करें जिन्हें आपको मेज़र करना है. उदाहरण के लिए, जब कोई उपयोगकर्ता ऑटोकंप्लीट ड्रॉप-डाउन सूची से चुनता है और कोई पता चुनता है, जैसा कि नीचे दी गई इमेज में दिखाया गया है.

आपके तय किए गए इवेंट और तरीके का इस्तेमाल करने वाले Google Analytics को, नीचे दिया गया ट्रैकिंग कॉल भेजा जा सकता है. (पढ़ने में आसानी के लिए, हम हर क्वेरी पैरामीटर को एक अलग लाइन में दिखाएंगे.)

https://www.google-analytics.com/g/collect?v=2
&tid=G-XR5B5D4NW0
>m=2oe550
&_p=64678170
&sr=1920x1200
&ul=fr
&cid=489856786.1598861364
&_s=2
&dl=http%3A%2F%2.storelocator.html
&dt=Store%20Locator
&sid=1620827159
&sct=1
&seg=1
&en=location
&_et=6032
&ep.method=address

यहां दिए गए डायग्राम में यह दिखाया गया है कि नेटवर्क टैब पर, ब्राउज़र के 'जांच करें' व्यू में, Google Analytics कॉल कैसा दिखता है. (बड़ा करने के लिए क्लिक करें).

Google Analytics में "रीयल-टाइम" व्यू देखकर पुष्टि की जा सकती है कि आपके कस्टम इवेंट टैग सही तरीके से कैप्चर किए जा रहे हैं या नहीं. उदाहरण के लिए, 'जगह की जानकारी अपने-आप पूरा होना' के लिए पहले सेट अप किया गया "जगह की जानकारी" इवेंट, Google Analytics में दिखता है. नीचे दिए गए आंकड़ों में इसका उदाहरण दिया गया है.

इसके अलावा, आपके पास DebugView का इस्तेमाल करके रीयल-टाइम इवेंट पर नज़र रखने का विकल्प भी है, जैसा कि यहां दी गई इमेज में दिखाया गया है. ध्यान दें कि Google Analytics के जुड़ाव > इवेंट सेक्शन में, पूरी इवेंट रिपोर्ट को ऐक्सेस करने के लिए आपको 24 घंटे इंतज़ार करना होगा.

अपने लोकेटर ऐप्लिकेशन से, जगहों पर आने वाले लोगों की संख्या बढ़ाने के लिए, रणनीतियां बनाई और मेज़र की जा सकती हैं. उदाहरण के लिए, Google Analytics में Analytics में स्टोर विज़िट की सुविधा है, जो फ़िज़िकल स्टोर विज़िट आंकड़ों (Google Ads से मेज़र किए गए) को आपके लोकेटर ऐनलिटिक्स से लिंक करती है. आपके पास खुद के ऐप्लिकेशन को एक जगह से दूसरी जगह ले जाने की रणनीतियां बनाने का विकल्प भी है. जैसे, कारोबार की जगहों पर रिडीम किए जा सकने वाले ऑनलाइन ऑफ़र.

Business Profile की मेट्रिक

Business Profile में Google Analytics का इस्तेमाल करने वाले इवेंट, मेट्रिक, और डाइमेंशन ट्रैक करने के साथ-साथ, उसकी अपनी metrics भी होती हैं. उदाहरण के लिए, अपने लोकेटर में अपॉइंटमेंट बुकिंग और स्थानीय ऑफ़र के लिंक जोड़ने पर, आपको उन व्यू और क्लिक की मेट्रिक मिल सकती हैं.

Business Profile API को सैंपल के तौर पर, नीचे दिए गए अनुरोध में कई तरह की मेट्रिक मांगी जाती हैं. ऑफ़र पर मिलने वाले क्लिक को ट्रैक करने के लिए, LOCAL_POST_VIEWS_SEARCH और LOCAL_POST_ACTIONS_CALL_TO_ACTION मेट्रिक सबसे ज़्यादा काम की होंगी.

POST https://mybusiness.googleapis.com/v4/accounts/111098884960528804666/locations:reportInsights
Body:
{
 "locationNames": [
   "accounts/111098884960528804666/locations/15899957830169237700"
 ],
 "basicRequest": {
         "metricRequests": [
            {
              "metric": "QUERIES_DIRECT"
            },
            {
              "metric": "QUERIES_INDIRECT"
            },
            {
              "metric": "VIEWS_MAPS"
            },
            {
              "metric": "VIEWS_SEARCH"
            },
            {
                "metric": "ACTIONS_DRIVING_DIRECTIONS"
            },
            {
                "metric": "LOCAL_POST_VIEWS_SEARCH"
            },
            {
                "metric": "LOCAL_POST_ACTIONS_CALL_TO_ACTION"
            }
         ],
         "timeRange": {
              "startTime": "2021-01-01T01:01:23.045123456Z",
              "endTime": "2021-04-30T23:59:59.045123456Z"
         }
   }
}

{
   "locationMetrics": [
       {
           "locationName": "accounts/111098884960528804666/locations/15899957830169237700",
           "timeZone": "Asia/Singapore",
           "metricValues": [
               {
                   "metric": "QUERIES_DIRECT",
                   "totalValue": {
                       "metricOption": "AGGREGATED_TOTAL",
                       "timeDimension": {
                           "timeRange": {
                               "startTime": "2021-01-01T01:01:23.045123456Z",
                               "endTime": "2021-04-30T23:59:59.045123456Z"
                           }
                       },
                       "value": "82"
                   }
               },
               {
                   "metric": "QUERIES_INDIRECT",
                   "totalValue": {
                       "metricOption": "AGGREGATED_TOTAL",
                       "timeDimension": {
                           "timeRange": {
                               "startTime": "2021-01-01T01:01:23.045123456Z",
                               "endTime": "2021-04-30T23:59:59.045123456Z"
                           }
                       },
                       "value": "1493"
                   }
               },
               {
                   "metric": "VIEWS_MAPS",
                   "totalValue": {
                       "metricOption": "AGGREGATED_TOTAL",
                       "timeDimension": {
                           "timeRange": {
                               "startTime": "2021-01-01T01:01:23.045123456Z",
                               "endTime": "2021-04-30T23:59:59.045123456Z"
                           }
                       },
                       "value": "1571"
                   }
               },
               {
                   "metric": "VIEWS_SEARCH",
                   "totalValue": {
                       "metricOption": "AGGREGATED_TOTAL",
                       "timeDimension": {
                           "timeRange": {
                               "startTime": "2021-01-01T01:01:23.045123456Z",
                               "endTime": "2021-04-30T23:59:59.045123456Z"
                           }
                       },
                       "value": "631"
                   }
               },
               {
                   "metric": "ACTIONS_DRIVING_DIRECTIONS",
                   "totalValue": {
                       "metricOption": "AGGREGATED_TOTAL",
                       "timeDimension": {
                           "timeRange": {
                               "startTime": "2021-01-01T01:01:23.045123456Z",
                               "endTime": "2021-04-30T23:59:59.045123456Z"
                           }
                       },
                       "value": "3"
                   }
               },
               {
                   "metric": "LOCAL_POST_ACTIONS_CALL_TO_ACTION",
                   "totalValue": {
                       "metricOption": "AGGREGATED_TOTAL",
                       "timeDimension": {
                           "timeRange": {
                               "startTime": "2021-01-01T01:01:23.045123456Z",
                               "endTime": "2021-04-30T23:59:59.045123456Z"
                           }
                       },
                       "value": "42"
                   }
               },
               {
                   "metric": "LOCAL_POST_VIEWS_SEARCH",
                   "totalValue": {
                       "metricOption": "AGGREGATED_TOTAL",
                       "timeDimension": {
                           "timeRange": {
                               "startTime": "2021-01-01T01:01:23.045123456Z",
                               "endTime": "2021-04-30T23:59:59.045123456Z"
                           }
                       },
                       "value": "11"
                   }
               }
           ]
       }
   ]
}

रिस्पॉन्स में ये मेट्रिक शामिल होती हैं, जिनमें सबसे खास तौर पर ये शामिल हैं:

• Google Maps पर किसी जगह को 1571 व्यू मिले
• Google Search पर जगह को 631 व्यू मिले.
• किसी जगह पर पहुंचने के लिए, ड्राइविंग दिशा-निर्देश के लिए तीन अनुरोध.
• 42 LOCAL_POST_ACTIONS_CALL_TO_ACTION प्रॉडक्ट को मिले क्लिक.
• Google Search पर मौजूद स्थानीय पोस्ट को 11 व्यू मिले.

मेट्रिक के एक और विकल्प में कार्रवाई लिंक बनाने के लिए Google से रिज़र्व का इस्तेमाल करना शामिल है. जब उपयोगकर्ता, Reserve with Google में बनाए गए कार्रवाई के लिंक पर क्लिक करते हैं, तब उन कार्रवाइयों को Google Analytics में लॉग किया जा सकता है. इससे, Google Analytics में कन्वर्ज़न ट्रैक किए जा सकते हैं. ज़्यादा जानकारी के लिए, कन्वर्ज़न ट्रैकिंग दस्तावेज़ देखें.

आप चाहे किसी भी मेट्रिक रणनीति का इस्तेमाल करें, मेज़रमेंट के तहत यह देखने से कहीं ज़्यादा मदद मिलती है कि केपीआई के साथ आपकी परफ़ॉर्मेंस कैसी है. इन आंकड़ों से आपको यह समझने में भी मदद मिलती है कि लोकेटर में किए गए इन सुधारों का आपके कारोबार पर क्या असर पड़ा है. इसके अलावा, अपने लोकेटर पर Google Analytics की मेट्रिक की तुलना Business Profile की मेट्रिक से की जा सकती है. उदाहरण के लिए, इन मेट्रिक की तुलना करके, यह देखा जा सकता है कि कितने ग्राहकों को आपके लोकेटर और Google Maps से आपके कारोबार की जगहों पर जाने का रास्ता मिल रहा है.

लोकेटर प्लस को बेहतर बनाया जा रहा है

अपने कारोबार या उपयोगकर्ताओं की ज़रूरतों के मुताबिक, लोगों के अनुभव को और बेहतर बनाया जा सकता है.

उपयोगकर्ता किसी जगह तक आसानी से पहुंच सकें, इसके लिए उन्हें मैसेज या ईमेल से रास्ते का लिंक भेजा जा सकता है. जब लोग इस पर क्लिक करेंगे, तो उनके फ़ोन पर Google Maps ऐप्लिकेशन लॉन्च हो जाएगा. हालांकि, इसके लिए ज़रूरी है कि ऐप्लिकेशन इंस्टॉल हो. ऐसा भी हो सकता है कि Maps.google.com उसके डिवाइस के वेब ब्राउज़र में लोड हो जाए. ये दोनों तरीके उपयोगकर्ता को अपनी मंज़िल तक पहुंचने के लिए, मोड़-दर-मोड़ नेविगेशन का विकल्प देते हैं. इसमें, आवाज़ से रास्ता बताने की सुविधा भी शामिल है.

मैप के यूआरएल का इस्तेमाल करके निर्देश का ऐसा यूआरएल बनाएं जो नीचे दिया गया हो. साथ ही, यूआरएल के कोड में बदली गई जगह का नाम destination पैरामीटर के तौर पर और जगह के आईडी को destination_place_id पैरामीटर के तौर पर इस्तेमाल करें. Maps के यूआरएल लिखने या इस्तेमाल करने के लिए कोई शुल्क नहीं लगता. इसलिए, आपको यूआरएल में एपीआई पासकोड शामिल करने की ज़रूरत नहीं है.

      https://www.google.com/maps/dir/?api=1&destination=Google%20London&destination_place_id=ChIJVSZzVR8FdkgRTyQkxxLQmVU

डेस्टिनेशन के पते के फ़ॉर्मैट का इस्तेमाल करके, वैकल्पिक तौर पर origin क्वेरी पैरामीटर दिया जा सकता है. हालांकि, इसे हटाने से, उपयोगकर्ता की मौजूदा जगह से निर्देश मिलते हैं. यह जगह, लोकेटर प्लस ऐप्लिकेशन का इस्तेमाल करने वाली जगह से अलग हो सकती है. मैप के यूआरएल में क्वेरी पैरामीटर के अन्य विकल्प मिलते हैं, जैसे कि नेविगेशन चालू होने पर निर्देश लॉन्च करने के लिए travelmode और dir_action=navigate.

क्लिक किया जा सकने वाला यह लिंक, जो ऊपर उदाहरण के तौर पर दिए गए यूआरएल को शामिल करता है. यह origin को लंदन फ़ुटबॉल स्टेडियम के तौर पर सेट करता है और मंज़िल तक पहुंचने के लिए सार्वजनिक परिवहन के निर्देश देने के लिए travelmode=transit का इस्तेमाल करता है.

इस यूआरएल वाला टेक्स्ट या ईमेल भेजने के लिए, हमारा सुझाव है कि फ़िलहाल हम किसी तीसरे पक्ष के ऐप्लिकेशन, जैसे कि twilio का इस्तेमाल करें. अगर App Engine का इस्तेमाल किया जा रहा है, तो मैसेज (एसएमएस) या ईमेल भेजने के लिए तीसरे पक्ष की कंपनियों की मदद ली जा सकती है. ज़्यादा जानकारी के लिए, तीसरे पक्ष की सेवाओं से मैसेज भेजना देखें.

दुनिया की कई जगहों के लिए, Street View का इस्तेमाल करके किसी जगह को बाहर से देखा जा सकता है. इससे, लोगों को वहां पहुंचने से पहले ही फ़ोटो की झलक दिख जाती है. आप Street View को इंटरैक्टिव (वेब) या स्टैटिक (एपीआई) फ़ॉर्म में दे सकते हैं. यह इस बात पर निर्भर करता है कि आपके उपयोगकर्ताओं को 360 डिग्री में इलाके को "आस-पास" देखने की सुविधा देनी है या नहीं. Street View Android और iOS के लिए भी उपलब्ध है.

ज़्यादातर मामलों में, लोगों के डिवाइसों या ब्राउज़र में पहले से मौजूद जगह की जानकारी का इस्तेमाल करके, उनकी जगह की जानकारी का पता लगाया जा सकता है. हमने Google मैप पर किसी उपयोगकर्ता या डिवाइस की भौगोलिक जगह दिखाने के लिए, ब्राउज़र की HTML5 जियोलोकेशन सुविधा का इस्तेमाल करने का उदाहरण दिया है. साथ ही, Android और iOS में अनुमतियों के अनुरोध करने और जगह की जानकारी पाने से जुड़े दस्तावेज़ उपलब्ध हैं. हालांकि, कुछ मामलों में जगह की जानकारी का पता लगाने की सुविधा का इस्तेमाल करना पड़ सकता है. उदाहरण के लिए, ऐसा तब हो सकता है, जब डिवाइस की जगह की जानकारी की सुविधा बंद हो या आपको डिवाइस की जगह की जानकारी के झूठे नाम से मेल भेजने को लेकर चिंता हो.

Geolocation API एक सर्वर-साइड एपीआई है. यह सेल टावर और वाई-फ़ाई नोड के बारे में पता लगाई जा सकने वाली जानकारी के आधार पर, जगह और सटीक जानकारी का दायरा दिखाता है. उपयोगकर्ता की जगह की जानकारी का पता लगाने के लिए, बैकअप तरीके के तौर पर जियोलोकेशन का इस्तेमाल किया जा सकता है. इसके अलावा, इसका इस्तेमाल डिवाइस से रिपोर्ट की गई जगह की दोबारा जांच करने के लिए भी किया जा सकता है.

जगह की जानकारी उपलब्ध कराने के पिछले सेक्शन में, हमने जगह की जानकारी का इस्तेमाल करके, उपयोगकर्ताओं को आपके कारोबार की जगह के बारे में खास जानकारी दी थी. जैसे, कारोबार के खुले होने का समय, फ़ोटो, और समीक्षाएं.

जगह की जानकारी में अलग-अलग डेटा फ़ील्ड की लागत को समझना मददगार होता है. इन फ़ील्ड को बुनियादी, संपर्क, और वातावरण का डेटा की कैटगरी में रखा जाता है. अपनी लागतों को मैनेज करने के लिए, एक रणनीति यह है कि आप अपने कारोबार की जगहों के बारे में पहले से मौजूद जानकारी को Google Maps से मिली ताज़ा जानकारी (आम तौर पर, बेसिक और संपर्क डेटा) के साथ मिला दें. जैसे- कुछ समय के लिए बंद रहने का समय, छुट्टी के दिन कारोबार के खुले होने का समय, उपयोगकर्ता रेटिंग, फ़ोटो, और समीक्षाएं. अगर आपके पास अपने स्थानों की संपर्क जानकारी पहले से है, तो आपको स्थान विवरण से उन फ़ील्ड का अनुरोध करने की ज़रूरत नहीं होगी और आप जो दिखाना चाहते हैं उसके आधार पर अपने अनुरोध को केवल मूल या वायुमंडल डेटा फ़ील्ड को फ़ेच करने के लिए सीमित कर सकते हैं.

'जगह की जानकारी' के बजाय, जोड़ी या इस्तेमाल की जा सकने वाली जगह का डेटा हो सकता है. फ़ुल स्टैक लोकेटर के लिए, codelab में आपको जगह की जानकारी सेव करने और उसे वापस पाने के लिए डेटाबेस के साथ GeoJSON का इस्तेमाल करने का तरीका बताया गया है.