JavaScript का इस्तेमाल करके मार्कर के साथ Google मैप जोड़ें

शुरुआती जानकारी

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

नीचे वह मैप दिया गया है जिसे इस ट्यूटोरियल का इस्तेमाल करके बनाया जाएगा. मार्कर को ऊलुरु-काटा तजुता नैशनल पार्क में उलुरु (जिसे आयर्स रॉक भी कहा जाता है) में रखा गया है.

प्रारंभ करना

आपके वेब पेज पर मार्कर के साथ Google मैप बनाने के तीन चरण हैं:

  1. एपीआई पासकोड पाएं
  2. एचटीएमएल पेज बनाना
  3. मार्कर के साथ मैप जोड़ना

आपको वेब ब्राउज़र की ज़रूरत होगी. इस्तेमाल किए जा सकने वाले ब्राउज़र की सूची में से, अपने प्लैटफ़ॉर्म के हिसाब से, Google Chrome (सुझाया गया), Firefox, Safari या Edge जैसा कोई लोकप्रिय ऐप्लिकेशन चुनें.

पहला चरण: एपीआई पासकोड पाना

इस सेक्शन में, एपीआई पासकोड का इस्तेमाल करके, Maps JavaScript API में अपने ऐप्लिकेशन की पुष्टि करने का तरीका बताया गया है.

API कुंजी प्राप्त करने के लिए इन चरणों का पालन करें:

  1. Google Cloud Console पर जाएं.

  2. कोई प्रोजेक्ट बनाएं या चुनें.

  3. एपीआई और उससे जुड़ी किसी भी सेवा को चालू करने के लिए, जारी रखें पर क्लिक करें.

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

  5. कोटा चोरी होने से बचाने और अपनी एपीआई कुंजी को सुरक्षित करने के लिए, एपीआई पासकोड का इस्तेमाल करना देखें.

  6. बिलिंग चालू करें. ज़्यादा जानकारी के लिए, इस्तेमाल और बिलिंग देखें.

  7. एक API कुंजी मिल जाने के बाद, "YOUR_API_KEY" पर क्लिक करके उसे निम्न स्निपेट में जोड़ें. अपने वेब पेज पर इस्तेमाल करने के लिए, बूटलोडर स्क्रिप्ट टैग को कॉपी करके चिपकाएं.

    <script>
      (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
        key: "YOUR_API_KEY",
        v: "weekly",
        // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
        // Add other bootstrap parameters as needed, using camel case.
      });
    </script>
    
    style="height: 400 पिक्सल"

दूसरा चरण: एचटीएमएल पेज बनाना

बेसिक एचटीएमएल वेब पेज का कोड यहां दिया गया है:

<!doctype html>
<!--
 @license
 Copyright 2019 Google LLC. All Rights Reserved.
 SPDX-License-Identifier: Apache-2.0
-->
<html>
  <head>
    <title>Add Map</title>

    <link rel="stylesheet" type="text/css" href="./style.css" />
    <script type="module" src="./index.js"></script>
  </head>
  <body>
    <h3>My Google Maps Demo</h3>
    <!--The div element for the map -->
    <div id="map"></div>

    <!-- prettier-ignore -->
    <script>(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})
        ({key: "AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg", v: "weekly"});</script>
  </body>
</html>

ध्यान दें कि यह एक बहुत ही सामान्य पेज है, जिसमें हेडिंग लेवल तीन (h3) और एक div एलिमेंट है. वेब पेज पर अपनी पसंद का कोई भी कॉन्टेंट जोड़ा जा सकता है.

कोड को समझें

नीचे दिया गया कोड एक HTML पेज बनाता है, जिसमें एक शीर्षक और एक मुख्य भाग शामिल होता है.

<html>
 <head>
 </head>
 <body>
 </body>
</html>

आप नीचे दिए गए कोड का उपयोग करके मैप के ऊपर एक हेडिंग लेवल तीन जोड़ सकते हैं.

<h3>My Google Maps Demo</h3>

नीचे दिया गया कोड आपके Google मैप के लिए पेज का एक क्षेत्र परिभाषित करता है.

<!--The div element for the map -->
<div id="map"></div>

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

/* Set the size of the div element that contains the map */
#map {
    height: 400px; /* The height is 400 pixels */
    width: 100%; /* The width is the width of the web page */
}

ऊपर दिए गए कोड में, style एलिमेंट आपके मैप के लिए div का साइज़ सेट करता है. मैप देखने के लिए, div की चौड़ाई और ऊंचाई को 0 पिक्सल से ज़्यादा पर सेट करें. इस मामले में, div को आपके वेब पेज की पूरी चौड़ाई दिखाने के लिए 400 पिक्सल की ऊंचाई और 100% चौड़ाई पर सेट किया गया है.

बूटस्ट्रैप लोडर, लोड होने के लिए Maps JavaScript API को तैयार करता है (जब तक importLibrary() को कॉल नहीं किया जाता, तब तक कोई लाइब्रेरी लोड नहीं होती).

<script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "weekly",
    // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
    // Add other bootstrap parameters as needed, using camel case.
  });
</script>

अपना एपीआई पासकोड पाने से जुड़े निर्देशों के लिए, तीसरा चरण: एपीआई पासकोड पाना देखें.

चरण 3: मार्कर की मदद से मैप जोड़ना

इस सेक्शन में आपको अपने वेब पेज पर Maps JavaScript API को लोड करने का तरीका और मार्कर के साथ मैप जोड़ने के लिए एपीआई का इस्तेमाल करने वाला JavaScript कोड लिखने का तरीका बताया गया है.

TypeScript

// Initialize and add the map
let map;
async function initMap(): Promise<void> {
  // The location of Uluru
  const position = { lat: -25.344, lng: 131.031 };

  // Request needed libraries.
  //@ts-ignore
  const { Map } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary;
  const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;

  // The map, centered at Uluru
  map = new Map(
    document.getElementById('map') as HTMLElement,
    {
      zoom: 4,
      center: position,
      mapId: 'DEMO_MAP_ID',
    }
  );

  // The marker, positioned at Uluru
  const marker = new AdvancedMarkerElement({
    map: map,
    position: position,
    title: 'Uluru'
  });
}

initMap();

JavaScript

// Initialize and add the map
let map;

async function initMap() {
  // The location of Uluru
  const position = { lat: -25.344, lng: 131.031 };
  // Request needed libraries.
  //@ts-ignore
  const { Map } = await google.maps.importLibrary("maps");
  const { AdvancedMarkerElement } = await google.maps.importLibrary("marker");

  // The map, centered at Uluru
  map = new Map(document.getElementById("map"), {
    zoom: 4,
    center: position,
    mapId: "DEMO_MAP_ID",
  });

  // The marker, positioned at Uluru
  const marker = new AdvancedMarkerElement({
    map: map,
    position: position,
    title: "Uluru",
  });
}

initMap();

ऊपर दिए गए कोड में, जब initMap() फ़ंक्शन को कॉल किया जाता है, तो Map और AdvancedMarkerView लाइब्रेरी लोड होती हैं.

कोड को समझें

नीचे दिया गया कोड एक नया Google Maps ऑब्जेक्ट बनाता है. साथ ही, मैप में बीच और ज़ूम लेवल जैसी प्रॉपर्टी जोड़ देता है. प्रॉपर्टी के दूसरे विकल्पों के बारे में जानने के लिए दस्तावेज़ देखें.

TypeScript

// The location of Uluru
const position = { lat: -25.344, lng: 131.031 };

// Request needed libraries.
//@ts-ignore
const { Map } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary;
const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;

// The map, centered at Uluru
map = new Map(
  document.getElementById('map') as HTMLElement,
  {
    zoom: 4,
    center: position,
    mapId: 'DEMO_MAP_ID',
  }
);

JavaScript

// The location of Uluru
const position = { lat: -25.344, lng: 131.031 };
// Request needed libraries.
//@ts-ignore
const { Map } = await google.maps.importLibrary("maps");
const { AdvancedMarkerElement } = await google.maps.importLibrary("marker");

// The map, centered at Uluru
map = new Map(document.getElementById("map"), {
  zoom: 4,
  center: position,
  mapId: "DEMO_MAP_ID",
});

ऊपर दिए गए कोड में, new Map() एक नया Google Maps ऑब्जेक्ट बनाता है. center प्रॉपर्टी, एपीआई को बताती है कि मैप को कहां फ़ोकस करना है.

अक्षांश/देशांतर निर्देशांक पाने या किसी पते को भौगोलिक निर्देशांक में बदलने के बारे में ज़्यादा जानें.

zoom प्रॉपर्टी से मैप का ज़ूम लेवल तय होता है. ज़ूम: 0 सबसे कम ज़ूम है और पूरे Earth को दिखाता है. उच्च रिज़ॉल्यूशन पर Earth में ज़ूम इन करने के लिए ज़ूम मान को ज़्यादा पर सेट करें.

नीचे दिया गया कोड मैप पर एक मार्कर लगाता है. position प्रॉपर्टी, मार्कर की स्थिति सेट करती है.

TypeScript

// The marker, positioned at Uluru
const marker = new AdvancedMarkerElement({
  map: map,
  position: position,
  title: 'Uluru'
});

JavaScript

// The marker, positioned at Uluru
const marker = new AdvancedMarkerElement({
  map: map,
  position: position,
  title: "Uluru",
});

उदाहरण के तौर पर दिए गए कोड को पूरा करें

उदाहरण के तौर पर दिया गया पूरा कोड यहां देखें:

TypeScript

// Initialize and add the map
let map;
async function initMap(): Promise<void> {
  // The location of Uluru
  const position = { lat: -25.344, lng: 131.031 };

  // Request needed libraries.
  //@ts-ignore
  const { Map } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary;
  const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;

  // The map, centered at Uluru
  map = new Map(
    document.getElementById('map') as HTMLElement,
    {
      zoom: 4,
      center: position,
      mapId: 'DEMO_MAP_ID',
    }
  );

  // The marker, positioned at Uluru
  const marker = new AdvancedMarkerElement({
    map: map,
    position: position,
    title: 'Uluru'
  });
}

initMap();

JavaScript

// Initialize and add the map
let map;

async function initMap() {
  // The location of Uluru
  const position = { lat: -25.344, lng: 131.031 };
  // Request needed libraries.
  //@ts-ignore
  const { Map } = await google.maps.importLibrary("maps");
  const { AdvancedMarkerElement } = await google.maps.importLibrary("marker");

  // The map, centered at Uluru
  map = new Map(document.getElementById("map"), {
    zoom: 4,
    center: position,
    mapId: "DEMO_MAP_ID",
  });

  // The marker, positioned at Uluru
  const marker = new AdvancedMarkerElement({
    map: map,
    position: position,
    title: "Uluru",
  });
}

initMap();

सीएसएस

/* 
 * Always set the map height explicitly to define the size of the div element
 * that contains the map. 
 */
#map {
  height: 100%;
}

/* 
 * Optional: Makes the sample page fill the window. 
 */
html,
body {
  height: 100%;
  margin: 0;
  padding: 0;
}

एचटीएमएल

<html>
  <head>
    <title>Add Map</title>

    <link rel="stylesheet" type="text/css" href="./style.css" />
    <script type="module" src="./index.js"></script>
  </head>
  <body>
    <h3>My Google Maps Demo</h3>
    <!--The div element for the map -->
    <div id="map"></div>

    <!-- prettier-ignore -->
    <script>(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})
        ({key: "AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg", v: "weekly"});</script>
  </body>
</html>

सैंपल आज़माएं

मार्कर के बारे में ज़्यादा जानें:

सलाह और समस्या का हल

  • मैप को पसंद के मुताबिक बनाने के लिए, आपके पास स्टाइल और प्रॉपर्टी जैसे विकल्पों में बदलाव करने का विकल्प होता है. मैप को पसंद के मुताबिक बनाने के बारे में ज़्यादा जानकारी के लिए, स्टाइल और मैप पर ड्रॉइंग बनाने की गाइड पढ़ें.
  • अपने कोड की जांच करने और उसे चलाने, गड़बड़ी की रिपोर्ट पढ़ने, और कोड से जुड़ी समस्याएं हल करने के लिए, अपने वेब ब्राउज़र में Developer Tools Console का इस्तेमाल करें.
  • Chrome में कंसोल खोलने के लिए, यहां दिए गए कीबोर्ड शॉर्टकट का इस्तेमाल करें:
    Command+Option+J (Mac पर) या Control+Shift+J (Windows पर).
  • Google Maps पर किसी जगह के अक्षांश और देशांतर निर्देशांक देखने के लिए, नीचे दिया गया तरीका अपनाएं.

    1. किसी ब्राउज़र में Google Maps खोलें.
    2. मैप पर उस सटीक जगह पर राइट क्लिक करें जिसके लिए आपको निर्देशांकों की ज़रूरत है.
    3. इसके बाद दिखने वाले 'संदर्भ मेन्यू' से यहां क्या है को चुनें. मैप में स्क्रीन पर सबसे नीचे एक कार्ड दिखता है. कार्ड की आखिरी पंक्ति में अक्षांश और देशांतर निर्देशांक देखें.
  • जियोकोडिंग सेवा का इस्तेमाल करके आप किसी पते को अक्षांश और देशांतर निर्देशांक में बदल सकते हैं. डेवलपर गाइड जियोकोडिंग सेवा का इस्तेमाल शुरू करने के बारे में ज़्यादा जानकारी देती हैं.