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

खास जानकारी

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

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

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

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

एपीआई चालू किए जा रहे हैं

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

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

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

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

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

इसे चालू करने के कई तरीके हैं: (1) इस फ़ंक्शन को बॉक्स से बाहर कराने के लिए, क्विक बिल्डर लोकेटर प्लस समाधान का इस्तेमाल करना और (2) अपने डाइनैमिक मैप को लागू करने के तरीके का इस्तेमाल करना. इस सेक्शन में इन विकल्पों के बारे में ज़्यादा जानकारी दी गई है.

क्विक बिल्डर लोकेटर प्लस का इस्तेमाल करना

अपने कारोबार की प्रोफ़ाइल से कारोबार की जानकारी इंपोर्ट करने के लिए, Quick Builder Locator Plus Solutions का इस्तेमाल किया जा सकता है. इसलिए, आपके कारोबार की प्रोफ़ाइल में दी गई कारोबार की जानकारी में बदलाव, अब आपकी वेबसाइट पर स्टोर लोकेटर में दिखेगा. इन बदलावों में खुले होने का समय, संपर्क जानकारी, फ़ोटो, और सेवा के विकल्प वगैरह शामिल हो सकते हैं. क्विक बिल्डर की मदद से, आप मैप पर कारोबार की जगहों को तेज़ी से सेट अप कर सकते हैं. साथ ही, डिप्लॉय करने लायक कोड जनरेट कर सकते हैं या कुछ ही मिनटों में सीधे 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() ऊपर दिए गए "map" 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 में उस जगह की जानकारी के साथ-साथ, भौगोलिक निर्देशांक और उपयोगकर्ता से मिली जानकारी भी शामिल होती है. अपने डेटाबेस में, हर जगह से जुड़ा जगह का आईडी ढूंढें. आप जगहों के एपीआई की मदद से खोजने की सुविधा में, प्लेस एंडपॉइंट ढूंढें पर कॉल कर सकते हैं और सिर्फ़ 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

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

जगह की जानकारी को कोड में बदलना

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

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

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 पर कॉल करने के बाद, आप जवाब को किसी जानकारी विंडो, वेब साइडबार या किसी भी अन्य तरीके से फ़िल्टर और रेंडर कर सकते हैं.

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

नीचे दिए गए उदाहरण में, प्लेस लाइब्रेरी और 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 पर अपने-आप पूरी जानकारी देने वाली लाइब्रेरी में, कुछ क्वेरी पैरामीटर जोड़ने के बारे में, Maps पर अपने-आप पूरी जानकारी देने वाली लाइब्रेरी में यूआरएल जोड़ना न भूलें. नीचे दिए गए उदाहरण में, 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 आपके उपयोगकर्ताओं को उस जगह को चुनने में मदद करता है जो उनके लिए सबसे ज़्यादा समय और सड़क की दूरी तय करती है.

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

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

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

नीचे दिया गया उदाहरण, दूरी की मैट्रिक्स सेवा को कॉल करता है. इसमें उपयोगकर्ता के नाम और जगहों की जानकारी दी गई है. यह उदाहरण, मैप सेंटर से लंदन के तीन 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) क्विक बिल्डर लोकेटर प्लस सलूशन का इस्तेमाल करके, इस फ़ंक्शन को बॉक्स से बाहर करना और (2) अपने Business Profile का इस्तेमाल करना. इस सेक्शन में इन विकल्पों के बारे में ज़्यादा जानकारी दी गई है.

क्विक बिल्डर लोकेटर प्लस का इस्तेमाल करना

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

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

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

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

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

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

1. APPOINTMENT, ONLINE_APPOINTMENT या DINING_RESERVATION टाइप की जगह के लिए, Business Profile API 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 API से ये कॉल करें:

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

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

   नीचे दिया गया उदाहरण LIST कॉल के जवाब में एक 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. placeActionLink पैनल में मौजूद साइड डेटा के साथ, साइड पैनल में <div> बनाएं और अपने-आप भरें. खास तौर पर, अपॉइंटमेंट बुक करने के लिंक का यूआरआई.

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

अगर आप किसी कारोबार की प्रोफ़ाइल को मैनेज नहीं करते हैं या क्विक बिल्डर लोकेटर प्लस सलूशन का इस्तेमाल नहीं करना चाहते हैं, तो बुकिंग विजेट की जांच करने के लिए, अपॉइंटमेंट बुक करने का प्लैटफ़ॉर्म देखें. इसमें, 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 API से ये कॉल करें:

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

   Business Profile API में, जगह और ईमेल की जानकारी के लिए एक उदाहरण यहां दिया गया है:

   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 एपीआई कस्टम मार्कर विषय में सोर्स कोड देखें.)

ज़्यादा जानकारी के लिए, 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_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 से जुड़े आंकड़े कॉन्फ़िगर करने और उनकी निगरानी करने के बारे में बताया गया है. इन आंकड़ों की मदद से, आप जिस डेटा में सबसे ज़्यादा दिलचस्पी रखते हैं उसे ट्रैक कर सकते हैं. क्विक बिल्डर लोकेटर प्लस उपयोगकर्ताओं के लिए, 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 लागू करने की प्रक्रिया का इस्तेमाल करके, नीचे दिए गए काम करें:

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

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

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

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 में जाकर, यह पुष्टि की जा सकती है कि आपके कस्टम इवेंट टैग सही तरीके से कैप्चर किए जा रहे हैं. इसके लिए, कोटेशन को रीयल-टाइम और कोट में देखें. उदाहरण के लिए, ऑटोकंप्लीट की सुविधा के लिए पहले सेट अप किया गया "location" इवेंट, नीचे दिए गए आंकड़ों में दिखाए गए तरीके से Google Analytics में दिखता है.

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

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

कारोबारी प्रोफ़ाइल की मेट्रिक

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

Business Profile के एपीआई के लिए, सैंपल के तौर पर दिया गया यह अनुरोध कई तरह की मेट्रिक का अनुरोध करता है. ऑफ़र पर होने वाले क्लिक को ट्रैक करने के लिए, 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 व्यू मिले.

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

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

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

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

उपयोगकर्ता किसी जगह तक आसानी से पहुंच सकें, इसके लिए आप उन्हें निर्देश का लिंक टेक्स्ट या ईमेल कर सकते हैं. जब उपयोगकर्ता इस बटन पर क्लिक करेंगे, तो वे अपने फ़ोन पर 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 का इस्तेमाल कर रहे हैं, तो आप मैसेज (एसएमएस) या ईमेल भेजने के लिए तीसरे पक्ष की कंपनियों का इस्तेमाल कर सकते हैं. ज़्यादा जानकारी के लिए, तीसरे पक्ष की सेवाओं से मैसेज भेजना देखें.

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

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

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

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

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

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