मैप के एलिमेंट के हिसाब से कैमरे को अपने-आप फ़िट करना

<gmp-map-3d> व्यूपोर्ट में मार्कर, पॉलीलाइन, पॉलीगॉन, और 3D रूट को अपने-आप फ़्रेम किया जा सकता है. इसके लिए, काम करने वाले चाइल्ड एलिमेंट पर autofits-camera एचटीएमएल एट्रिब्यूट या autofitsCamera प्रॉपर्टी सेट करें. जब एक या उससे ज़्यादा चाइल्ड एलिमेंट शामिल होते हैं, तो मैप कैमरे की ऐसी पोज़िशन कैलकुलेट करता है जिससे शामिल किए गए सभी एलिमेंट व्यू में बने रहें.

कैमरे को अपने-आप फ़िट करने की सुविधा, Maps JavaScript API के v=beta चैनल में उपलब्ध है. बीटा चैनल लोड करने के निर्देशों के लिए, वर्शनिंग देखें.

इस्तेमाल किए जा सकने वाले एलिमेंट

इस टेबल में, Map3DElement के वे चाइल्ड एलिमेंट दिए गए हैं जो autofits-camera (autofitsCamera) के साथ काम करते हैं:

एचटीएमएल एलिमेंट JavaScript क्लास लाइब्रेरी नोट
<gmp-marker-3d>, <gmp-marker-3d-interactive> Marker3DElement, Marker3DInteractiveElement maps3d मार्कर के position को फ़्रेम करता है.
<gmp-marker>, <gmp-marker-interactive> MarkerElement, MarkerInteractiveElement maps3d मार्कर के position को फ़्रेम करता है.
<gmp-polyline-3d>, <gmp-polyline-3d-interactive> Polyline3DElement, Polyline3DInteractiveElement maps3d पॉलीलाइन के path में सभी निर्देशांक फ़्रेम करता है.
<gmp-polygon-3d>, <gmp-polygon-3d-interactive> Polygon3DElement, Polygon3DInteractiveElement maps3d यह पॉलीगॉन के path में मौजूद सभी निर्देशांकों को फ़्रेम करता है.
<gmp-route-3d> Route3DElement routes रास्ते के अनुरोध का जवाब मिलने का इंतज़ार करता है. इसके बाद, रास्ते का पाथ तय करता है.

इंपोर्ट नहीं किए जा सकने वाले एलिमेंट

Model3DElement, PopoverElement, और FlattenerElement में autofitsCamera का इस्तेमाल नहीं किया जा सकता. उन एलिमेंट को फ़्रेम करने के लिए, <gmp-map-3d> पर center और range सेट करें या flyCameraTo को कॉल करें.

शुरुआती लोड पर कैमरे को फ़िट करना

मैप लोड होने पर एलिमेंट को फ़्रेम करने के लिए, शुरुआती व्यूपोर्ट में मौजूद हर चाइल्ड एलिमेंट में autofits-camera एट्रिब्यूट जोड़ें. आपको <gmp-map-3d> पर center या range का हिसाब लगाने की ज़रूरत नहीं है:

<gmp-map-3d
  style="height: 400px; width: 100%;"
  mode="hybrid">
  <gmp-marker-3d
    position="47.6205,-122.3493"
    title="Space Needle"
    autofits-camera>
  </gmp-marker-3d>
  <gmp-marker-3d
    position="47.6097,-122.3425"
    title="Pike Place Market"
    autofits-camera>
  </gmp-marker-3d>
  <gmp-polyline-3d
    path="47.6205,-122.3493,0 47.6097,-122.3425,0"
    stroke-color="#4285F4"
    stroke-width="8"
    altitude-mode="clamp-to-ground"
    autofits-camera>
  </gmp-polyline-3d>
</gmp-map-3d>

<script async
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&libraries=maps3d">
</script>

YOUR_API_KEY को अपने Google Maps Platform API पासकोड से बदलें.

डाइनैमिक अपडेट को फ़िट और ऐनिमेट करना

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

डाइनैमिक अपडेट स्नैप होंगे या ऐनिमेट, यह कंट्रोल करने के लिए Map3DElement पर autofitsCameraAnimation (autofits-camera-animation) को AutofitsCameraAnimation वैल्यू पर सेट करें:

  • AutofitsCameraAnimation.NONE ("none", डिफ़ॉल्ट): बिना ऐनिमेशन के, अपडेट की गई पोज़िशन पर स्नैप करता है.
  • AutofitsCameraAnimation.FLY_TO ("fly-to"): अपडेट की गई पोज़िशन पर आसानी से ले जाता है. मैप लोड होने पर, शुरुआत में स्नैप बिना ऐनिमेशन के दिखता है. साथ ही, जब उपयोगकर्ता का ऑपरेटिंग सिस्टम कम मोशन का अनुरोध करता है, तो FLY_TO स्नैप पर वापस चला जाता है.

प्रोग्राम के हिसाब से autofitsCamera और AutofitsCameraAnimation.FLY_TO को कॉन्फ़िगर करने के लिए, यह उदाहरण देखें:

<div id="map-container" style="height: 400px; width: 100%;"></div>

<script>
  async function initMap() {
    const {
      AutofitsCameraAnimation,
      Map3DElement,
      Marker3DElement,
      MapMode,
    } = await google.maps.importLibrary('maps3d');

    const map = new Map3DElement({
      mode: MapMode.HYBRID,
      autofitsCameraAnimation: AutofitsCameraAnimation.FLY_TO,
    });
    document.getElementById('map-container').append(map);

    const originMarker = new Marker3DElement({
      position: { lat: 37.7955, lng: -122.3937 },
      autofitsCamera: true,
    });
    map.append(originMarker);

    /* Adding a second opted-in marker flies the camera to frame both. */
    const destinationMarker = new Marker3DElement({
      position: { lat: 37.8080, lng: -122.4177 },
      autofitsCamera: true,
    });
    map.append(destinationMarker);
  }
</script>
<script async
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&loading=async&callback=initMap">
</script>

YOUR_API_KEY को अपने Google Maps Platform API पासकोड से बदलें.

कैमरे की प्रॉपर्टी और पाबंदियां कैसे इंटरैक्ट करती हैं

जब कम से कम एक चाइल्ड एलिमेंट autofits-camera के साथ शामिल होता है, तो Map3DElement आपके मैप कॉन्फ़िगरेशन को इन नियमों के हिसाब से कैलकुलेट की गई सीमाओं के साथ जोड़ता है:

  • center और range: कैलकुलेट किए गए फ़्रेमिंग से ओवरराइड किया गया है. इससे 20% रेंज पैडिंग जुड़ती है और कम से कम 80 मीटर की रेंज लागू होती है. अगर शामिल होने के लिए चुने गए किसी भी चाइल्ड एलिमेंट से निर्देशांक नहीं मिलते हैं, तो मैप अपने कॉन्फ़िगर किए गए center और range को फ़ॉलबैक के तौर पर इस्तेमाल करता है.
  • tilt और heading: फ़्रेमिंग के दौरान, इन्हें सुझाई गई वैल्यू के तौर पर माना जाता है. अगर इन्हें शामिल नहीं किया जाता है, तो दोनों की वैल्यू डिफ़ॉल्ट रूप से 0° पर सेट हो जाती है. इससे टॉप-डाउन और नॉर्थ-अप व्यू दिखता है.
  • roll और fov: Map3DElement को कॉन्फ़िगर किए गए डेटा को सुरक्षित रखा गया है.
  • एसिंक्रोनस चाइल्ड एलिमेंट: शुरुआती व्यू को रेंडर करने से पहले, Map3DElement, ऑप्ट-इन किए गए एसिंक्रोनस चाइल्ड एलिमेंट, जैसे कि <gmp-route-3d> के लिए, रूट ज्यामिति को लोड होने का इंतज़ार करता है.
  • मैप और कैमरे से जुड़ी पाबंदियां: भौगोलिक bounds और कैमरे की सीमाएं (minAltitude, maxAltitude, minTilt, maxTilt, minHeading, और maxHeading) अब भी ऑटोफ़िट किए गए व्यू को सीमित करती हैं. ज़्यादा जानकारी के लिए, कैमरे के व्यू और सीमाओं पर पाबंदी लगाना लेख पढ़ें.

अगले चरण