การสนับสนุน

หน้านี้แสดงปัญหาที่ทราบและวิธีแก้ปัญหาสำหรับฟีเจอร์แผนที่เวกเตอร์และ WebGL

การรองรับเบราว์เซอร์/อุปกรณ์

ตัวอย่างฟีเจอร์ WebGL รองรับเบราว์เซอร์และอุปกรณ์เดียวกับ Maps JavaScript API หากต้องการตรวจสอบว่าเบราว์เซอร์ในอุปกรณ์หนึ่งๆ จะรองรับ WebGL หรือไม่ ให้ไปที่ get.webgl.org หรือ caniuse.com โปรดตรวจสอบด้วยว่าได้เปิดใช้ การเร่งฮาร์ดแวร์ในการตั้งค่าเบราว์เซอร์แล้ว มิฉะนั้นแผนที่เวกเตอร์ จะเปลี่ยนกลับเป็นแรสเตอร์

แรสเตอร์หรือเวกเตอร์

บางครั้งแผนที่เวกเตอร์อาจเปลี่ยนกลับไปเป็นแรสเตอร์ เมื่อเกิดเหตุการณ์นี้ขึ้น ฟีเจอร์ ที่ขึ้นอยู่กับแผนที่เวกเตอร์จะใช้งานไม่ได้ การเปลี่ยนไปใช้แผนที่แรสเตอร์อาจเกิดขึ้นได้ จากหลายสาเหตุ ส่วนนี้จะแสดงวิธีกำหนดค่า เว็บเบราว์เซอร์อย่างถูกต้อง และวิธีตรวจสอบแบบเป็นโปรแกรมว่ามีความสามารถของแผนที่เวกเตอร์ หรือไม่

ตรวจสอบความสามารถของเบราว์เซอร์ใน Chrome

หากต้องการดูว่าการติดตั้ง Chrome เวอร์ชันใดเปิดใช้ความสามารถในการเร่งฮาร์ดแวร์ ให้ไปที่ chrome://gpu/ และตรวจสอบว่ารายการต่อไปนี้เปิดใช้อยู่ (เป็นสีเขียว)

  • "OpenGL: เปิดใช้"
  • "WebGL: เร่งด้วยฮาร์ดแวร์"
  • "WebGL2: เร่งด้วยฮาร์ดแวร์"

(นี่เป็นเพียงข้อกำหนดพื้นฐาน อาจมีปัจจัยอื่นๆ ที่ส่งผลต่อการสนับสนุน โปรดดู "ข้อบกพร่องที่ทราบ" ด้านล่าง)

เปิดการเร่งฮาร์ดแวร์

หากต้องการรองรับแผนที่เวกเตอร์ คุณต้องเปิดใช้การเร่งฮาร์ดแวร์ในเบราว์เซอร์ส่วนใหญ่ หากต้องการเปิดใช้การเร่งฮาร์ดแวร์ใน Chrome และ Microsoft Edge ให้เปิดการตั้งค่า เลือกระบบ และตรวจสอบว่าได้เปิดใช้ใช้การเร่งฮาร์ดแวร์เมื่อสามารถใช้ได้แล้ว

ตรวจสอบแรสเตอร์หรือเวกเตอร์โดยใช้โปรแกรม

คุณสามารถตรวจสอบได้โดยอัตโนมัติว่าแผนที่เป็นแบบแรสเตอร์หรือเวกเตอร์โดย เรียกใช้ map.getRenderingType() ตัวอย่างต่อไปนี้แสดงโค้ดสําหรับตรวจสอบ เหตุการณ์ renderingtype_changed และแสดงหน้าต่างข้อมูลที่ระบุว่ามีการใช้แผนที่ แรสเตอร์หรือเวกเตอร์

TypeScript

/**
 * This example creates a map with an info window that shows whether
 * the map render type is raster or vector.
 */

 function initMap() {
    const center = {lat: 0, lng: 0};
    const map = new google.maps.Map(document.getElementById('map') as HTMLElement, {
      center,
      zoom: 10,
      heading: 0.0,
      tilt: 0.0,
      // Map ID for a vector map.
      mapId: '6ff586e93e18149f',
    });
    const canvas = document.createElement("canvas");
    const infoWindow = new google.maps.InfoWindow({
      content: '',
      ariaLabel: 'Raster/Vector',
      position: center,
    });
    infoWindow.open({
      map,
    });

    map.addListener('renderingtype_changed', () => {
      infoWindow.setContent(`${map.getRenderingType()}`);
    });
  }

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

JavaScript

/**
 * This example creates a map with an info window that shows whether
 * the map render type is raster or vector.
 */
function initMap() {
  const center = { lat: 0, lng: 0 };
  const map = new google.maps.Map(document.getElementById("map"), {
    center,
    zoom: 10,
    heading: 0.0,
    tilt: 0.0,
    // Map ID for a vector map.
    mapId: "6ff586e93e18149f",
  });
  const canvas = document.createElement("canvas");
  const infoWindow = new google.maps.InfoWindow({
    content: "",
    ariaLabel: "Raster/Vector",
    position: center,
  });

  infoWindow.open({
    map,
  });
  map.addListener("renderingtype_changed", () => {
    infoWindow.setContent(`${map.getRenderingType()}`);
  });
}

window.initMap = initMap;
index.js

นอกจากนี้ คุณยังใช้บริบทการแสดงผล WebGL เพื่อตรวจสอบการรองรับ WebGL 2 ได้ด้วย โดยทำดังนี้

const canvas = document.createElement("canvas");
canvas.getContext("webgl2") ? console.log("WebGL 2 is supported") : console.log("WebGL 2 is NOT supported");

ดูวิธีอื่นๆ ในการตรวจหาบริบทการแสดงผล WebGL โดยอัตโนมัติ

การรองรับเว็บบนอุปกรณ์เคลื่อนที่

การรองรับเว็บบนอุปกรณ์เคลื่อนที่สำหรับแผนที่เวกเตอร์ยังอยู่ในรุ่นทดลอง นักพัฒนาแอปสามารถใช้ API ฝั่งไคลเอ็นต์เพื่อตรวจหาเว็บเบราว์เซอร์บนอุปกรณ์เคลื่อนที่ และใช้รหัสแผนที่ที่เชื่อมโยงกับ แผนที่แรสเตอร์แทนแผนที่เวกเตอร์ เราคาดว่าอุปกรณ์เคลื่อนที่บางรุ่นอาจมีประสิทธิภาพการแสดงผลช้าลง หากเลือกใช้แผนที่เวกเตอร์บนเว็บในอุปกรณ์เคลื่อนที่ เรา ขอขอบคุณอย่างยิ่งสำหรับสถิติประสิทธิภาพและความคิดเห็น ดังที่กล่าวไว้ข้างต้น หากไม่รองรับ แผนที่เวกเตอร์ ระบบจะเปลี่ยนไปใช้แผนที่แรสเตอร์โดยอัตโนมัติ

ข้อบกพร่อง

ข้อบกพร่องที่ทราบ

  • มีปัญหาที่ทราบใน Chrome บนอุปกรณ์ macOS บางรุ่นที่มี GPU ของ AMD ซึ่งอาจสร้างความสับสนเป็นอย่างยิ่งเมื่อ macOS สลับระหว่าง GPU แบบไดนามิกใน อุปกรณ์ที่มี GPU หลายตัว ดังนั้นแผนที่เวกเตอร์อาจไม่พร้อมใช้งาน ทั้งนี้ขึ้นอยู่กับ แอปอื่นๆ ที่กำลังทำงานอยู่ หรือมีการเชื่อมต่อจอภาพภายนอกหรือไม่ การเปิดใช้แบ็กเอนด์ ANGLE Metal ที่กำลังจะเปิดตัวของ Chrome ดูเหมือนจะแก้ไขปัญหานี้ได้ในบางกรณี คุณติดตามแผนการเปิดตัวทั่วไปสำหรับฟีเจอร์นี้ได้ที่ https://bugs.chromium.org/p/chromium/issues/detail?id=1322521

การรายงานข้อบกพร่อง

  • โปรดอัปเดตเบราว์เซอร์และไดรเวอร์ GPU เป็นเวอร์ชันล่าสุดก่อนรายงานข้อบกพร่อง
  • ตรวจสอบว่าได้เปิดใช้การตั้งค่าการเร่งฮาร์ดแวร์ที่ chrome://settings/system (Chrome), about:preferences#general (Firefox), edge://settings/system (Microsoft Edge) แล้ว ใน Safari การตั้งค่านี้จะเปิดใช้โดยอัตโนมัติใน macOS เวอร์ชัน 10.15 ขึ้นไป สำหรับ MacOS เวอร์ชันเก่า โปรดไปที่การตั้งค่าขั้นสูงของ Safari และตรวจสอบว่าได้เปิดใช้ตัวเลือก "ใช้การเร่งฮาร์ดแวร์" แล้ว
  • ใส่ลิงก์โค้ดตัวอย่าง jsfiddle ในรายงานข้อบกพร่อง
  • โปรดถ่ายภาพหน้าจอของ chrome://gpu (Chrome), about:support (Firefox) หรือ edge://gpu (Microsoft Edge) แนบข้อมูลที่เกี่ยวข้องกับ GPU ในรายงานข้อบกพร่องหากพบปัญหาการแสดงผล

บอกให้เรารู้ว่าคุณคิดอย่างไร

เราให้ความสำคัญกับความคิดเห็นของคุณในขณะที่เราพยายามสร้างประสบการณ์การใช้งานแผนที่เวกเตอร์ที่ดีที่สุดสำหรับคุณและผู้ใช้ปลายทาง โปรดแจ้งให้เราทราบในกรณีต่อไปนี้

  • มีข้อผิดพลาด JavaScript ใหม่หรือข้อบกพร่อง/ข้อขัดข้องที่คุณตรวจพบใน เว็บแอป
  • เวลาในการตอบสนองของสตาร์ทอัพสำหรับแผนที่เวกเตอร์แย่กว่าแผนที่แรสเตอร์อย่างมาก ในกรณีนี้ เมตริกสำหรับการถดถอยของเวลาในการตอบสนองในการเริ่มต้นจะมีประโยชน์อย่างมาก โดยทั่วไป เราต้องการทราบว่าเวลาในการตอบสนองของสตาร์ทอัพลดลงต่ำกว่าเกณฑ์ที่ยอมรับได้หรือไม่
  • ประสบการณ์การใช้งานแผนที่เวกเตอร์อาจไม่ราบรื่นเท่าที่ควร หากคุณบันทึกเมตริก FPS หรือ Jank เมตริกเหล่านี้จะแตกต่างกันอย่างไรระหว่างแผนที่เวกเตอร์กับแผนที่แรสเตอร์
  • ประสิทธิภาพจะแตกต่างกันอย่างมากตามเบราว์เซอร์

หากคุณได้ตั้งค่าการทดสอบ A/B เพื่อเปรียบเทียบแผนที่เวกเตอร์กับแผนที่แรสเตอร์ โปรดแชร์ความคิดเห็นเกี่ยวกับประสิทธิภาพที่คุณได้รับ เนื่องจากจะเป็นประโยชน์อย่างมาก ในการช่วยเราปรับแต่งฟีเจอร์