इस पेज का अनुवाद Cloud Translation API से किया गया है.

Elevation Service
संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

ध्यान दें: सर्वर-साइड लाइब्रेरी

खास जानकारी

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

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

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

शुरू करना

Maps JavaScript API में ऊंचाई बताने वाली सेवा का इस्तेमाल करने से पहले, पहले यह पक्का करें कि Google Cloud Console में Elevation API चालू हो. यह वही प्रोजेक्ट होना चाहिए जिसे आपने Maps JavaScript API के लिए सेट अप किया है.

चालू किए गए एपीआई की सूची देखने के लिए:

Google Cloud Console पर जाएं.
कोई प्रोजेक्ट चुनें बटन पर क्लिक करें. इसके बाद, Maps JavaScript API के लिए सेट अप किया गया प्रोजेक्ट चुनें और खोलें पर क्लिक करें.
डैशबोर्ड पर एपीआई की सूची में, Elevation API ढूंढें.
अगर आपको सूची में एपीआई दिखता है, तो इसका मतलब है कि आपका खाता सेट अप हो गया है. अगर एपीआई सूची में नहीं है, तो इसे चालू करें:
1. लाइब्रेरी टैब देखने के लिए, पेज पर सबसे ऊपर, एपीआई चालू करें चुनें. इसके अलावा, बाईं ओर मौजूद मेन्यू में, लाइब्रेरी चुनें.
2. Elevation API खोजें. इसके बाद, नतीजों की सूची से उसे चुनें.
3. चालू करें को चुनें. प्रोसेस पूरी होने के बाद, डैशबोर्ड पर एपीआई की सूची में Elevation API दिखता है.

कीमत और नीतियां

कीमत

JavaScript Elevation सेवा की कीमत और इस्तेमाल से जुड़ी नीतियों के बारे में जानने के लिए, Elevation API के लिए इस्तेमाल और बिलिंग देखें.

नीतियां

ऊंचाई की जानकारी देने वाली सेवा का इस्तेमाल, Elevation API के लिए बताई गई नीतियों के मुताबिक होना चाहिए.

बिल्डिंग की ऊंचाई की जानकारी देने के अनुरोध

ऊंचाई की जानकारी देने वाली सेवा को ऐसिंक्रोनस तरीके से ऐक्सेस किया जाता है, क्योंकि Google Maps API को किसी बाहरी सर्वर को कॉल करना पड़ता है. इसलिए, अनुरोध पूरा होने पर उसे लागू करने के लिए, आपको कॉलबैक तरीका देना होगा. इस कॉलबैक के तरीके से नतीजे प्रोसेस होने चाहिए. ध्यान दें कि ऊंचाई की जानकारी देने वाली सेवा, एक स्टेटस कोड (ElevationStatus) और अलग-अलग ElevationResult ऑब्जेक्ट का कलेक्शन दिखाती है.

ElevationService दो तरह के अनुरोधों को मैनेज करता है:

getElevationForLocations() तरीके का इस्तेमाल करके, अलग-अलग जगहों के लिए अनुरोध करता है. इसमें, LocationElevationRequest ऑब्जेक्ट का इस्तेमाल करके, एक या उससे ज़्यादा जगहों की सूची दी जाती है.
getElevationAlongPath() तरीके का इस्तेमाल करके, किसी पाथ के साथ-साथ जुड़े हुए पॉइंट की सीरीज़ पर ऊंचाई का अनुरोध करता है. इसमें, PathElevationRequest ऑब्जेक्ट में पाथ के वर्टिसेस का क्रम से लगाया गया सेट पास किया जाता है. पाथ के साथ-साथ ऊंचाई का अनुरोध करते समय, आपको एक पैरामीटर भी पास करना होगा. इससे यह पता चलता है कि आपको उस पाथ के साथ कितने सैंपल लेने हैं.

इनमें से हर तरीके को कॉलबैक तरीका भी पास करना होगा, ताकि रिटर्न किए गए ElevationResult और ElevationStatus ऑब्जेक्ट को मैनेज किया जा सके.

जगह की जानकारी के लिए ऊंचाई के अनुरोध

LocationElevationRequest ऑब्जेक्ट लिटरल में, ये फ़ील्ड होते हैं:

{
  locations[]: LatLng
}

locations (ज़रूरी है) से पृथ्वी पर उन जगहों की जानकारी मिलती है जहां से ऊंचाई का डेटा दिखाना है. यह पैरामीटर, LatLng के ऐरे को स्वीकार करता है.

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

सैंपल किए गए पाथ की ऊंचाई के अनुरोध

PathElevationRequest ऑब्जेक्ट लिटरल में ये फ़ील्ड होते हैं:

{
  path[]: LatLng,
  samples: Number
}

इन फ़ील्ड के बारे में यहां बताया गया है:

path (ज़रूरी है) से पृथ्वी पर एक पाथ तय होता है, जिसकी ऊंचाई का डेटा दिखाना है. path पैरामीटर, दो या उससे ज़्यादा LatLng ऑब्जेक्ट के ऐरे का इस्तेमाल करके, दो या उससे ज़्यादा क्रम में लगाए गए {latitude,longitude} पेयर का सेट तय करता है.
samples (ज़रूरी है) से, किसी पाथ पर मौजूद सैंपल पॉइंट की संख्या पता चलती है. इन पॉइंट के लिए, ऊंचाई का डेटा दिखाया जाता है. samples पैरामीटर, दिए गए path को पाथ के साथ-साथ बराबर दूरी वाले पॉइंट के क्रम में लगाए गए सेट में बांटता है.

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

ऊंचाई से जुड़े जवाब

हर मान्य अनुरोध के लिए, Elevation सेवा तय किए गए कॉलबैक में ElevationStatus ऑब्जेक्ट के साथ-साथ ElevationResult ऑब्जेक्ट का एक सेट दिखाएगी.

एलिवेशन के स्टेटस

ऊंचाई का हर अनुरोध, अपने कॉलबैक फ़ंक्शन में एक ElevationStatus कोड दिखाता है. इस status कोड में, इनमें से कोई एक वैल्यू होगी:

OK, जिससे पता चलता है कि सेवा का अनुरोध पूरा हो गया है
INVALID_REQUEST, जिससे पता चलता है कि सेवा का अनुरोध सही तरीके से नहीं किया गया था
OVER_QUERY_LIMIT, यह बताता है कि अनुरोध करने वाले व्यक्ति ने कोटा से ज़्यादा अनुरोध किए हैं
REQUEST_DENIED, यह बताता है कि सेवा ने अनुरोध पूरा नहीं किया. ऐसा, शायद अमान्य पैरामीटर की वजह से हुआ हो
UNKNOWN_ERROR, जो किसी अज्ञात गड़बड़ी की जानकारी देता है

आपको यह देखना चाहिए कि आपका कॉलबैक कामयाब हुआ है या नहीं. इसके लिए, OK के लिए इस स्टेटस कोड की जांच करें.

ऊंचाई के नतीजे

पुष्टि हो जाने पर, आपके कॉलबैक फ़ंक्शन के results आर्ग्युमेंट में ElevationResult ऑब्जेक्ट का एक सेट शामिल होगा. इन ऑब्जेक्ट में ये एलिमेंट शामिल होते हैं:

उस जगह का location एलिमेंट (जिसमें LatLng ऑब्जेक्ट शामिल हैं) जिसके लिए ऊंचाई का डेटा कैलकुलेट किया जा रहा है. ध्यान दें कि पाथ के अनुरोधों के लिए, location एलिमेंट के सेट में पाथ के साथ सैंपल किए गए पॉइंट शामिल होंगे.
elevation एलिमेंट, जो जगह की ऊंचाई को मीटर में दिखाता है.
resolution वैल्यू, जो उन डेटा पॉइंट के बीच की सबसे ज़्यादा दूरी दिखाती है जिनसे ऊंचाई का अनुमान लगाया गया था. यह दूरी मीटर में होती है. अगर समस्या का समाधान नहीं पता है, तो यह प्रॉपर्टी मौजूद नहीं होगी. ध्यान दें कि एक से ज़्यादा पॉइंट पास होने पर, ऊंचाई का डेटा ज़्यादा गलत हो जाता है (resolution की वैल्यू बड़ी हो जाती है). किसी पॉइंट के लिए ऊंचाई की सबसे सटीक वैल्यू पाने के लिए, अलग से क्वेरी की जानी चाहिए.

ऊंचाई के उदाहरण

नीचे दिया गया कोड, मैप पर क्लिक करने की जानकारी को LocationElevationRequest ऑब्जेक्ट का इस्तेमाल करके, ऊंचाई के अनुरोध में बदल देता है:

TypeScript

function initMap(): void {
  const map = new google.maps.Map(
    document.getElementById("map") as HTMLElement,
    {
      zoom: 8,
      center: { lat: 63.333, lng: -150.5 }, // Denali.
      mapTypeId: "terrain",
    }
  );
  const elevator = new google.maps.ElevationService();
  const infowindow = new google.maps.InfoWindow({});

  infowindow.open(map);

  // Add a listener for the click event. Display the elevation for the LatLng of
  // the click inside the infowindow.
  map.addListener("click", (event) => {
    displayLocationElevation(event.latLng, elevator, infowindow);
  });
}

function displayLocationElevation(
  location: google.maps.LatLng,
  elevator: google.maps.ElevationService,
  infowindow: google.maps.InfoWindow
) {
  // Initiate the location request
  elevator
    .getElevationForLocations({
      locations: [location],
    })
    .then(({ results }) => {
      infowindow.setPosition(location);

      // Retrieve the first result
      if (results[0]) {
        // Open the infowindow indicating the elevation at the clicked position.
        infowindow.setContent(
          "The elevation at this point <br>is " +
            results[0].elevation +
            " meters."
        );
      } else {
        infowindow.setContent("No results found");
      }
    })
    .catch((e) =>
      infowindow.setContent("Elevation service failed due to: " + e)
    );
}

declare global {
  interface Window {
    initMap: () => void;
  }
}
window.initMap = initMap;index.ts

JavaScript

function initMap() {
  const map = new google.maps.Map(document.getElementById("map"), {
    zoom: 8,
    center: { lat: 63.333, lng: -150.5 }, // Denali.
    mapTypeId: "terrain",
  });
  const elevator = new google.maps.ElevationService();
  const infowindow = new google.maps.InfoWindow({});

  infowindow.open(map);
  // Add a listener for the click event. Display the elevation for the LatLng of
  // the click inside the infowindow.
  map.addListener("click", (event) => {
    displayLocationElevation(event.latLng, elevator, infowindow);
  });
}

function displayLocationElevation(location, elevator, infowindow) {
  // Initiate the location request
  elevator
    .getElevationForLocations({
      locations: [location],
    })
    .then(({ results }) => {
      infowindow.setPosition(location);
      // Retrieve the first result
      if (results[0]) {
        // Open the infowindow indicating the elevation at the clicked position.
        infowindow.setContent(
          "The elevation at this point <br>is " +
            results[0].elevation +
            " meters.",
        );
      } else {
        infowindow.setContent("No results found");
      }
    })
    .catch((e) =>
      infowindow.setContent("Elevation service failed due to: " + e),
    );
}

window.initMap = initMap;index.js

उदाहरण देखें

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

JSFiddle.net Google Cloud Shell

इस उदाहरण में, निर्देशांक के सेट के आधार पर एक पॉलीलाइन बनाई गई है. साथ ही, Google Visualization API का इस्तेमाल करके, उस पाथ के साथ ऊंचाई का डेटा दिखाया गया है. (आपको Google Common loader का इस्तेमाल करके, इस एपीआई को लोड करना होगा.) ऊंचाई का अनुरोध, PathElevationRequest का इस्तेमाल करके बनाया जाता है:

TypeScript

// Load the Visualization API and the columnchart package.
// @ts-ignore TODO update to newest visualization library
google.load("visualization", "1", { packages: ["columnchart"] });

function initMap(): void {
  // The following path marks a path from Mt. Whitney, the highest point in the
  // continental United States to Badwater, Death Valley, the lowest point.
  const path = [
    { lat: 36.579, lng: -118.292 }, // Mt. Whitney
    { lat: 36.606, lng: -118.0638 }, // Lone Pine
    { lat: 36.433, lng: -117.951 }, // Owens Lake
    { lat: 36.588, lng: -116.943 }, // Beatty Junction
    { lat: 36.34, lng: -117.468 }, // Panama Mint Springs
    { lat: 36.24, lng: -116.832 },
  ]; // Badwater, Death Valley

  const map = new google.maps.Map(
    document.getElementById("map") as HTMLElement,
    {
      zoom: 8,
      center: path[1],
      mapTypeId: "terrain",
    }
  );

  // Create an ElevationService.
  const elevator = new google.maps.ElevationService();

  // Draw the path, using the Visualization API and the Elevation service.
  displayPathElevation(path, elevator, map);
}

function displayPathElevation(
  path: google.maps.LatLngLiteral[],
  elevator: google.maps.ElevationService,
  map: google.maps.Map
) {
  // Display a polyline of the elevation path.
  new google.maps.Polyline({
    path: path,
    strokeColor: "#0000CC",
    strokeOpacity: 0.4,
    map: map,
  });

  // Create a PathElevationRequest object using this array.
  // Ask for 256 samples along that path.
  // Initiate the path request.
  elevator
    .getElevationAlongPath({
      path: path,
      samples: 256,
    })
    .then(plotElevation)
    .catch((e) => {
      const chartDiv = document.getElementById(
        "elevation_chart"
      ) as HTMLElement;

      // Show the error code inside the chartDiv.
      chartDiv.innerHTML = "Cannot show elevation: request failed because " + e;
    });
}

// Takes an array of ElevationResult objects, draws the path on the map
// and plots the elevation profile on a Visualization API ColumnChart.
function plotElevation({ results }: google.maps.PathElevationResponse) {
  const chartDiv = document.getElementById("elevation_chart") as HTMLElement;

  // Create a new chart in the elevation_chart DIV.
  const chart = new google.visualization.ColumnChart(chartDiv);

  // Extract the data from which to populate the chart.
  // Because the samples are equidistant, the 'Sample'
  // column here does double duty as distance along the
  // X axis.
  const data = new google.visualization.DataTable();

  data.addColumn("string", "Sample");
  data.addColumn("number", "Elevation");

  for (let i = 0; i < results.length; i++) {
    data.addRow(["", results[i].elevation]);
  }

  // Draw the chart using the data within its DIV.
  chart.draw(data, {
    height: 150,
    legend: "none",
    // @ts-ignore TODO update to newest visualization library
    titleY: "Elevation (m)",
  });
}

declare global {
  interface Window {
    initMap: () => void;
  }
}
window.initMap = initMap;index.ts

JavaScript

// Load the Visualization API and the columnchart package.
// @ts-ignore TODO update to newest visualization library
google.load("visualization", "1", { packages: ["columnchart"] });

function initMap() {
  // The following path marks a path from Mt. Whitney, the highest point in the
  // continental United States to Badwater, Death Valley, the lowest point.
  const path = [
    { lat: 36.579, lng: -118.292 }, // Mt. Whitney
    { lat: 36.606, lng: -118.0638 }, // Lone Pine
    { lat: 36.433, lng: -117.951 }, // Owens Lake
    { lat: 36.588, lng: -116.943 }, // Beatty Junction
    { lat: 36.34, lng: -117.468 }, // Panama Mint Springs
    { lat: 36.24, lng: -116.832 },
  ]; // Badwater, Death Valley
  const map = new google.maps.Map(document.getElementById("map"), {
    zoom: 8,
    center: path[1],
    mapTypeId: "terrain",
  });
  // Create an ElevationService.
  const elevator = new google.maps.ElevationService();

  // Draw the path, using the Visualization API and the Elevation service.
  displayPathElevation(path, elevator, map);
}

function displayPathElevation(path, elevator, map) {
  // Display a polyline of the elevation path.
  new google.maps.Polyline({
    path: path,
    strokeColor: "#0000CC",
    strokeOpacity: 0.4,
    map: map,
  });
  // Create a PathElevationRequest object using this array.
  // Ask for 256 samples along that path.
  // Initiate the path request.
  elevator
    .getElevationAlongPath({
      path: path,
      samples: 256,
    })
    .then(plotElevation)
    .catch((e) => {
      const chartDiv = document.getElementById("elevation_chart");

      // Show the error code inside the chartDiv.
      chartDiv.innerHTML = "Cannot show elevation: request failed because " + e;
    });
}

// Takes an array of ElevationResult objects, draws the path on the map
// and plots the elevation profile on a Visualization API ColumnChart.
function plotElevation({ results }) {
  const chartDiv = document.getElementById("elevation_chart");
  // Create a new chart in the elevation_chart DIV.
  const chart = new google.visualization.ColumnChart(chartDiv);
  // Extract the data from which to populate the chart.
  // Because the samples are equidistant, the 'Sample'
  // column here does double duty as distance along the
  // X axis.
  const data = new google.visualization.DataTable();

  data.addColumn("string", "Sample");
  data.addColumn("number", "Elevation");

  for (let i = 0; i < results.length; i++) {
    data.addRow(["", results[i].elevation]);
  }

  // Draw the chart using the data within its DIV.
  chart.draw(data, {
    height: 150,
    legend: "none",
    // @ts-ignore TODO update to newest visualization library
    titleY: "Elevation (m)",
  });
}

window.initMap = initMap;index.js

उदाहरण देखें

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

JSFiddle.net Google Cloud Shell

Elevation Service संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

खास जानकारी

शुरू करना

कीमत और नीतियां

कीमत

नीतियां

बिल्डिंग की ऊंचाई की जानकारी देने के अनुरोध

जगह की जानकारी के लिए ऊंचाई के अनुरोध

सैंपल किए गए पाथ की ऊंचाई के अनुरोध

ऊंचाई से जुड़े जवाब

एलिवेशन के स्टेटस

ऊंचाई के नतीजे

ऊंचाई के उदाहरण

TypeScript

JavaScript

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

TypeScript

JavaScript

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

Elevation Service
संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.