झुकाएं और घुमाएं

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript

सैंपल देखें

खास जानकारी

मैप शुरू करते समय heading और tilt प्रॉपर्टी शामिल करके, वेक्टर मैप पर झुकाने और घुमाने (हेडिंग) की सुविधा सेट की जा सकती है. साथ ही, मैप पर setTilt और setHeading तरीके को कॉल करके भी ऐसा किया जा सकता है. नीचे दिए गए उदाहरण में, मैप में कुछ बटन जोड़े गए हैं. ये बटन, अपने-आप 20-डिग्री की बढ़ोतरी और झुकाने की प्रक्रिया को अडजस्ट करते हुए दिखते हैं.

TypeScript

function initMap(): void {
  const map = new google.maps.Map(
    document.getElementById("map") as HTMLElement,
    {
      center: {
        lat: 37.7893719,
        lng: -122.3942,
      },
      zoom: 16,
      heading: 320,
      tilt: 47.5,
      mapId: "90f87356969d889c",
    }
  );

  const buttons: [string, string, number, google.maps.ControlPosition][] = [
    ["Rotate Left", "rotate", 20, google.maps.ControlPosition.LEFT_CENTER],
    ["Rotate Right", "rotate", -20, google.maps.ControlPosition.RIGHT_CENTER],
    ["Tilt Down", "tilt", 20, google.maps.ControlPosition.TOP_CENTER],
    ["Tilt Up", "tilt", -20, google.maps.ControlPosition.BOTTOM_CENTER],
  ];

  buttons.forEach(([text, mode, amount, position]) => {
    const controlDiv = document.createElement("div");
    const controlUI = document.createElement("button");

    controlUI.classList.add("ui-button");
    controlUI.innerText = `${text}`;
    controlUI.addEventListener("click", () => {
      adjustMap(mode, amount);
    });
    controlDiv.appendChild(controlUI);
    map.controls[position].push(controlDiv);
  });

  const adjustMap = function (mode: string, amount: number) {
    switch (mode) {
      case "tilt":
        map.setTilt(map.getTilt()! + amount);
        break;
      case "rotate":
        map.setHeading(map.getHeading()! + amount);
        break;
      default:
        break;
    }
  };
}

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

JavaScript

function initMap() {
  const map = new google.maps.Map(document.getElementById("map"), {
    center: {
      lat: 37.7893719,
      lng: -122.3942,
    },
    zoom: 16,
    heading: 320,
    tilt: 47.5,
    mapId: "90f87356969d889c",
  });
  const buttons = [
    ["Rotate Left", "rotate", 20, google.maps.ControlPosition.LEFT_CENTER],
    ["Rotate Right", "rotate", -20, google.maps.ControlPosition.RIGHT_CENTER],
    ["Tilt Down", "tilt", 20, google.maps.ControlPosition.TOP_CENTER],
    ["Tilt Up", "tilt", -20, google.maps.ControlPosition.BOTTOM_CENTER],
  ];

  buttons.forEach(([text, mode, amount, position]) => {
    const controlDiv = document.createElement("div");
    const controlUI = document.createElement("button");

    controlUI.classList.add("ui-button");
    controlUI.innerText = `${text}`;
    controlUI.addEventListener("click", () => {
      adjustMap(mode, amount);
    });
    controlDiv.appendChild(controlUI);
    map.controls[position].push(controlDiv);
  });

  const adjustMap = function (mode, amount) {
    switch (mode) {
      case "tilt":
        map.setTilt(map.getTilt() + amount);
        break;
      case "rotate":
        map.setHeading(map.getHeading() + amount);
        break;
      default:
        break;
    }
  };
}

window.initMap = 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;
}

.ui-button {
  background-color: #fff;
  border: 0;
  border-radius: 2px;
  box-shadow: 0 1px 4px -1px rgba(0, 0, 0, 0.3);
  margin: 10px;
  padding: 0 0.5em;
  font: 400 18px Roboto, Arial, sans-serif;
  overflow: hidden;
  height: 40px;
  cursor: pointer;
}
.ui-button:hover {
  background: rgb(235, 235, 235);
}

एचटीएमएल

<html>
  <head>
    <title>Tilt and Rotation</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>

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

माउस और कीबोर्ड जेस्चर का इस्तेमाल करना

अगर झुकाने और घुमाने (हेडिंग) से जुड़े उपयोगकर्ताओं के इंटरैक्शन की सुविधा (प्रोग्राम के हिसाब से या Google Cloud Console में) चालू की गई है, तो उपयोगकर्ता माउस और कीबोर्ड का इस्तेमाल करके, झुकाने और घुमाने की सुविधा को अडजस्ट कर सकते हैं:

  • माउस का इस्तेमाल करके, Shift बटन को दबाकर रखें, फिर झुकाने के लिए माउस पर क्लिक करके, ऊपर और नीचे की ओर खींचें और छोड़ें. साथ ही, हेडिंग को अडजस्ट करने के लिए दाएं और बाएं खींचें.
  • कीबोर्ड का इस्तेमाल करके, Shift बटन को दबाकर रखें, फिर झुकाने के लिए, ऊपर और नीचे की ओर वाले ऐरो बटन का इस्तेमाल करें. इसके बाद, हेडिंग को अडजस्ट करने के लिए, राइट और लेफ़्ट ऐरो का इस्तेमाल करें.

झुकाव और हेडिंग को प्रोग्राम के हिसाब से एडजस्ट करना

वेक्टर मैप पर झुकाएं और शीर्षक को प्रोग्राम के हिसाब से अडजस्ट करने के लिए, setTilt() और setHeading() तरीकों का इस्तेमाल करें. हेडिंग का मतलब है कि कैमरा घड़ी की दिशा में उत्तर की ओर है. इसलिए, map.setHeading(90) मैप को घुमाएगा, ताकि पूर्व दिशा ऊपर की ओर हो. झुकाने के कोण को ऊपर की ओर से मापा जाता है. इसलिए, map.setTilt(0) सीधे नीचे की ओर दिखता है, जबकि map.setTilt(45) से तिरछा व्यू दिखता है.

  • मैप का झुकाव कोण सेट करने के लिए setTilt() पर कॉल करें. मौजूदा झुकाव वैल्यू को पाने के लिए getTilt() का इस्तेमाल करें.
  • मैप का शीर्षक सेट करने के लिए, setHeading() पर कॉल करें. हेडिंग की मौजूदा वैल्यू पाने के लिए, getHeading() का इस्तेमाल करें.

टिल्ट और हेडिंग को बनाए रखते हुए मैप का केंद्र बदलने के लिए, map.setCenter() या map.panBy() का इस्तेमाल करें.

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

हेडिंग, टिल्ट, सेंटर, और ज़ूम को प्रोग्राम के हिसाब से बदलने के लिए, moveCamera तरीके का इस्तेमाल भी किया जा सकता है. ज़्यादा जानें.

अन्य तरीकों पर असर

मैप पर टिल्ट करने या घुमाने की सुविधा लागू होने पर, Maps JavaScript API के अन्य तरीकों के व्यवहार पर असर पड़ता है:

  • map.getBounds() हमेशा सबसे छोटा बाउंडिंग बॉक्स दिखाता है, जिसमें दिखने वाला क्षेत्र दिखता है. जब टिल्ट लागू किया जाता है, तो दिखाए गए बाउंड, मैप के व्यूपोर्ट में दिखने वाले क्षेत्र की तुलना में बड़े क्षेत्र को दिखा सकते हैं.
  • सीमाओं को फ़िट करने से पहले map.fitBounds(), झुकाव और हेडिंग को शून्य पर रीसेट कर देगा.
  • सीमाओं को पैन करने से पहले, map.panToBounds() टिल्ट और हेडिंग को शून्य पर रीसेट कर देगा.
  • map.setTilt() कोई भी मान स्वीकार करता है, लेकिन मैप के मौजूदा ज़ूम स्तर के आधार पर उसके ज़्यादा से ज़्यादा झुकाव को सीमित करता है.
  • map.setHeading() किसी भी वैल्यू को स्वीकार करता है और उसे रेंज [0, 360] में फ़िट करने के लिए बदल देता है.