Maps में डेटा इंपोर्ट करना

खास जानकारी

किसी स्थानीय या रिमोट सोर्स से GeoJSON डेटा इंपोर्ट करने और उसे अपने मैप पर दिखाने का तरीका जानें. यह ट्यूटोरियल मैप में डेटा इंपोर्ट करने की अलग-अलग तकनीकों को समझाने के लिए नीचे दिए गए मैप का इस्तेमाल करता है.

नीचे दिया गया सेक्शन वह पूरा कोड दिखाता है जिसकी ज़रूरत आपको इस ट्यूटोरियल में मैप बनाने के लिए होती है.

TypeScript

let map: google.maps.Map;

function initMap(): void {
  map = new google.maps.Map(document.getElementById("map") as HTMLElement, {
    zoom: 2,
    center: new google.maps.LatLng(2.8, -187.3),
    mapTypeId: "terrain",
  });

  // Create a <script> tag and set the USGS URL as the source.
  const script = document.createElement("script");

  // This example uses a local copy of the GeoJSON stored at
  // http://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/2.5_week.geojsonp
  script.src =
    "https://developers.google.com/maps/documentation/javascript/examples/json/earthquake_GeoJSONP.js";
  document.getElementsByTagName("head")[0].appendChild(script);
}

// Loop through the results array and place a marker for each
// set of coordinates.
const eqfeed_callback = function (results: any) {
  for (let i = 0; i < results.features.length; i++) {
    const coords = results.features[i].geometry.coordinates;
    const latLng = new google.maps.LatLng(coords[1], coords[0]);

    new google.maps.Marker({
      position: latLng,
      map: map,
    });
  }
};

declare global {
  interface Window {
    initMap: () => void;
    eqfeed_callback: (results: any) => void;
  }
}
window.initMap = initMap;
window.eqfeed_callback = eqfeed_callback;

JavaScript

let map;

function initMap() {
  map = new google.maps.Map(document.getElementById("map"), {
    zoom: 2,
    center: new google.maps.LatLng(2.8, -187.3),
    mapTypeId: "terrain",
  });

  // Create a <script> tag and set the USGS URL as the source.
  const script = document.createElement("script");

  // This example uses a local copy of the GeoJSON stored at
  // http://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/2.5_week.geojsonp
  script.src =
    "https://developers.google.com/maps/documentation/javascript/examples/json/earthquake_GeoJSONP.js";
  document.getElementsByTagName("head")[0].appendChild(script);
}

// Loop through the results array and place a marker for each
// set of coordinates.
const eqfeed_callback = function (results) {
  for (let i = 0; i < results.features.length; i++) {
    const coords = results.features[i].geometry.coordinates;
    const latLng = new google.maps.LatLng(coords[1], coords[0]);

    new google.maps.Marker({
      position: latLng,
      map: map,
    });
  }
};

window.initMap = initMap;
window.eqfeed_callback = eqfeed_callback;

सीएसएस

/* 
 * 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>Earthquake Markers</title>
    <script src="https://polyfill.io/v3/polyfill.min.js?features=default"></script>

    <link rel="stylesheet" type="text/css" href="./style.css" />
    <script type="module" src="./index.js"></script>
  </head>
  <body>
    <div id="map"></div>

    <!-- 
      The `defer` attribute causes the callback to execute after the full HTML
      document has been parsed. For non-blocking uses, avoiding race conditions,
      and consistent behavior across browsers, consider loading using Promises.
      See https://developers.google.com/maps/documentation/javascript/load-maps-js-api
      for more information.
      -->
    <script
      src="https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&v=weekly"
      defer
    ></script>
  </body>
</html>

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

डेटा लोड हो रहा है

इस सेक्शन में आपको बताया गया है कि अपने Maps JavaScript API ऐप्लिकेशन वाले डोमेन से या किसी दूसरे ऐप्लिकेशन से डेटा कैसे लोड करें.

एक ही डोमेन से डेटा लोड हो रहा है

Google Maps का डेटा लेयर, आर्बिट्रेरी जियोस्पेशियल डेटा (इसमें GeoJSON शामिल है) के लिए कंटेनर उपलब्ध कराता है. अगर आपका डेटा उसी डोमेन पर होस्ट की गई फ़ाइल में है जिसे आपके Maps JavaScript API ऐप्लिकेशन पर होस्ट किया गया है, तो आप उसे map.data.loadGeoJson() तरीके का इस्तेमाल करके लोड कर सकते हैं. फ़ाइल एक ही डोमेन पर होनी चाहिए, लेकिन उसे एक अलग सबडोमेन में होस्ट किया जा सकता है. उदाहरण के लिए, www.example.com से files.example.com को अनुरोध भेजा जा सकता है.

map.data.loadGeoJson('data.json');

कई डोमेन में डेटा लोड हो रहा है

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

Access-Control-Allow-Origin: *

किसी डोमेन में सीओआरएस चालू है या नहीं, यह जानने के लिए Chrome डेवलपर टूल (DevTool) का इस्तेमाल करें.

ऐसे डोमेन से डेटा लोड करना, एक ही डोमेन से JSON लोड करने जैसा है:

map.data.loadGeoJson('http://www.CORS-ENABLED-SITE.com/data.json');

JSONP का अनुरोध किया जा रहा है

इस तकनीक का इस्तेमाल करने के लिए, टारगेट डोमेन पर JSONP के लिए अनुरोध करने की सुविधा होनी चाहिए.

JSONP का अनुरोध करने के लिए, अपने दस्तावेज़ में सबसे ऊपर script टैग जोड़ने के लिए, createElement() का इस्तेमाल करें.

var script = document.createElement('script');
script.src = 'http://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/2.5_week.geojsonp';
document.getElementsByTagName('head')[0].appendChild(script);

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

उदाहरण के लिए, अपनी ब्राउज़र विंडो में http://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/2.5_week.geojsonp को लोड करें और कॉलबैक का नाम eqfeed_callback के तौर पर दिखाएं.

आपको अपने कोड में कॉलबैक स्क्रिप्ट परिभाषित करनी होगी:

function eqfeed_callback(response) {
  map.data.addGeoJson(response);
}

पार्स किए गए GeoJSON डेटा को मैप पर रखने के लिए, addGeoJson() तरीके का इस्तेमाल करें.

डेटा का लुक तय करना

मैप ऑब्जेक्ट में GeoJSON डेटा जोड़कर, अपने डेटा के दिखने का तरीका बदला जा सकता है. अपने डेटा को स्टाइल करने के बारे में ज़्यादा जानकारी के लिए, डेवलपर की गाइड पढ़ें.

ज़्यादा जानें

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