เพิ่ม Google Maps ที่มีเครื่องหมายโดยใช้ JavaScript

บทนำ

บทแนะนำนี้จะแสดงวิธีเพิ่มแผนที่ Google ที่มีเครื่องหมายลงในหน้าเว็บ โดยใช้ HTML, CSS และ JavaScript นอกจากนี้ยังแสดงวิธีตั้งค่าตัวเลือกแผนที่และ วิธีใช้การจัดสรรช่องควบคุมเพื่อเพิ่มป้ายกำกับลงในแผนที่

ด้านล่างนี้คือแผนที่ที่คุณจะสร้างโดยใช้บทแนะนำนี้ เครื่องหมายนี้อยู่ที่อุลูรู (หรือที่รู้จักกันในชื่อแอร์ส ร็อก) ใน อุทยานแห่งชาติอุลูรู-คาตา ทจูตา

เริ่มต้นใช้งาน

การสร้างแผนที่ Google ที่มีเครื่องหมายในหน้าเว็บมี 3 ขั้นตอนดังนี้

  1. รับคีย์ API
  2. สร้างหน้า HTML
  3. เพิ่มแผนที่ที่มีเครื่องหมาย

คุณต้องมีเว็บเบราว์เซอร์ เลือกเบราว์เซอร์ที่รู้จักกันดี เช่น Google Chrome (แนะนำ), Firefox, Safari หรือ Edge โดยอิงตามแพลตฟอร์มของคุณจากรายการเบราว์เซอร์ที่รองรับ

ขั้นตอนที่ 1: รับคีย์ API

ส่วนนี้อธิบายวิธีตรวจสอบสิทธิ์แอปกับ Maps JavaScript API โดยใช้คีย์ API ของคุณเอง

ทำตามขั้นตอนต่อไปนี้เพื่อรับคีย์ API

  1. ไปที่ Google Cloud Console

  2. สร้างหรือเลือกโปรเจ็กต์

  3. คลิกต่อไปเพื่อเปิดใช้ API และบริการที่เกี่ยวข้อง

  4. ในหน้าข้อมูลเข้าสู่ระบบ ให้รับคีย์ API (และตั้งค่าข้อจำกัดของคีย์ API) หมายเหตุ: หากมีคีย์ API ที่ไม่มีข้อจำกัดอยู่แล้ว หรือคีย์ที่มีข้อจำกัดของเบราว์เซอร์ คุณก็ใช้คีย์นั้นได้

  5. ดูการใช้คีย์ API เพื่อป้องกันการขโมยโควต้าและรักษาคีย์ API ให้ปลอดภัย

  6. เปิดใช้การเรียกเก็บเงิน ดูข้อมูลเพิ่มเติมได้ที่การใช้งานและการเรียกเก็บเงิน

  7. เมื่อได้คีย์ API แล้ว ให้เพิ่มคีย์ลงในข้อมูลโค้ดต่อไปนี้โดยคลิก "YOUR_API_KEY" คัดลอกและวางแท็กสคริปต์ Bootloader เพื่อใช้ใน หน้าเว็บของคุณเอง

    <script>
      (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
        key: "YOUR_API_KEY",
        v: "weekly",
        // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
        // Add other bootstrap parameters as needed, using camel case.
      });
    </script>

ขั้นตอนที่ 2: สร้างหน้า HTML

โค้ดสำหรับหน้าเว็บ HTML พื้นฐานมีดังนี้

<!DOCTYPE html>
<!--
 @license
 Copyright 2025 Google LLC. All Rights Reserved.
 SPDX-License-Identifier: Apache-2.0
-->

<html>
  <head>
    <title>Add a Map</title>

    <link rel="stylesheet" type="text/css" href="./style.css" />
    <script type="module" src="./index.js"></script>
    <!-- prettier-ignore -->
    <script>(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})
        ({key: "YOUR_API_KEY", v: "weekly"});</script>
  </head>
  <body>

    <!-- The map, centered at Uluru, Australia. -->
    <gmp-map center="-25.344,131.031" zoom="4" map-id="DEMO_MAP_ID">
    </gmp-map>

  </body>
</html>

นี่คือหน้า HTML พื้นฐานมากซึ่งใช้gmp-map เพื่อแสดงแผนที่ในหน้าเว็บ แผนที่จะว่างเปล่าเนื่องจากเรายังไม่ได้เพิ่มโค้ด JavaScript

ทำความเข้าใจโค้ด

ในตัวอย่างนี้ เรามีสิ่งต่อไปนี้

  • ประกาศแอปพลิเคชันเป็น HTML5 โดยใช้การประกาศ !DOCTYPE html
  • โหลด Maps JavaScript API โดยใช้โปรแกรมโหลด Bootstrap
  • สร้างองค์ประกอบ gmp-map เพื่อเก็บแผนที่

ประกาศแอปพลิเคชันเป็น HTML5

เราขอแนะนำให้คุณประกาศ DOCTYPE ที่ถูกต้องภายในเว็บแอปพลิเคชัน ในตัวอย่างที่นี่ เราได้ประกาศแอปพลิเคชันเป็น HTML5 โดยใช้ HTML5 DOCTYPE ดังที่แสดงด้านล่าง

<!DOCTYPE html>

เบราว์เซอร์ส่วนใหญ่ในปัจจุบันจะแสดงเนื้อหาที่ประกาศด้วย DOCTYPE ใน "โหมดมาตรฐาน" ซึ่งหมายความว่าแอปพลิเคชันของคุณควรเป็นไปตาม ข้อกำหนดของเบราว์เซอร์ต่างๆ มากขึ้น นอกจากนี้ DOCTYPE ยังออกแบบมาให้ลดระดับลงอย่างราบรื่นด้วย เบราว์เซอร์ที่ไม่เข้าใจจะเพิกเฉยต่อแท็กนี้ และใช้ "โหมดประหลาด" เพื่อ แสดงเนื้อหา

โปรดทราบว่า CSS บางรายการที่ใช้ได้ในโหมดประหลาดจะใช้ไม่ได้ในโหมดมาตรฐาน กล่าวคือ ขนาดที่เป็นเปอร์เซ็นต์ทั้งหมดต้องสืบทอด จากองค์ประกอบบล็อกระดับบน และหากบรรพบุรุษเหล่านั้นไม่ระบุขนาด ระบบจะถือว่ามีขนาด 0 x 0 พิกเซล ด้วยเหตุนี้ เราจึงขอstyleประกาศดังต่อไปนี้

<style>
  gmp-map {
    height: 100%;
  }
  html, body {
    height: 100%;
    margin: 0;
    padding: 0;
  }
</style>

โหลด Maps JavaScript API

โปรแกรมโหลด Bootstrap จะเตรียม Maps JavaScript API สำหรับการโหลด (ระบบจะไม่โหลดไลบรารีจนกว่าจะมีการเรียกใช้ importLibrary())

<script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "weekly",
    // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
    // Add other bootstrap parameters as needed, using camel case.
  });
</script>

ดูวิธีการรับคีย์ API ของคุณเองได้ที่ขั้นตอนที่ 3: รับคีย์ API

ในขั้นตอนนี้ของบทแนะนำ หน้าต่างว่างเปล่าจะปรากฏขึ้น โดยแสดงเฉพาะ ข้อความป้ายกำกับที่ไม่ได้จัดรูปแบบ เนื่องจากเรายังไม่ได้เพิ่มโค้ด JavaScript

สร้างองค์ประกอบ gmp-map

เราต้องจองพื้นที่สำหรับแผนที่เพื่อให้แสดงในหน้าเว็บได้ โดยทั่วไป เราจะทำเช่นนี้ด้วยการสร้างองค์ประกอบ gmp-map และรับการอ้างอิงถึงองค์ประกอบนี้ใน Document Object Model (DOM) ของเบราว์เซอร์ คุณยังใช้องค์ประกอบ div เพื่อดำเนินการนี้ได้ด้วย (ดูข้อมูลเพิ่มเติม) แต่ขอแนะนำให้ใช้องค์ประกอบ gmp-map

โค้ดด้านล่างกำหนดองค์ประกอบ gmp-map และตั้งค่าพารามิเตอร์ center, zoom และ map-id

<gmp-map center="-25.344,131.031" zoom="4" map-id="DEMO_MAP_ID">
</gmp-map>

ตัวเลือก center และ zoom เป็นตัวเลือกที่ต้องระบุเสมอ ในโค้ดด้านบน พร็อพเพอร์ตี้ center จะบอก API ว่าจะวางแผนที่ไว้ตรงไหน และพร็อพเพอร์ตี้ zoom จะ ระบุระดับการซูมสำหรับแผนที่ การซูม: 0 คือการซูมต่ำสุดและแสดง ทั้งโลก ตั้งค่าการซูมให้สูงขึ้นเพื่อซูมเข้าโลกที่ความละเอียดสูงขึ้น

ระดับการซูม

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

  • 1: โลก
  • 5: แผ่นดินหรือทวีป
  • 10: เมือง
  • 15: ถนน
  • 20: สิ่งปลูกสร้าง

รูปภาพ 3 รูปต่อไปนี้แสดงตำแหน่งเดียวกันในโตเกียวที่ระดับการซูม 0, 7 และ 18

โค้ดด้านล่างอธิบาย CSS ที่กำหนดขนาดขององค์ประกอบ gmp-map

/* Set the size of the gmp-map element that contains the map */
gmp-map {
    height: 400px; /* The height is 400 pixels */
    width: 100%; /* The width is the width of the web page */
}

ในโค้ดด้านบน องค์ประกอบ style จะกำหนดขนาดของ gmp-map ตั้งค่า ความกว้างและความสูงให้มากกว่า 0 พิกเซลเพื่อให้แผนที่แสดง ในกรณีนี้ gmp-map มีความสูง 400 พิกเซล และความกว้าง 100% เพื่อแสดงความกว้างของหน้าเว็บ ขอแนะนำให้ตั้งค่าสไตล์ความสูงและความกว้างอย่างชัดเจนเสมอ

การจัดช่องควบคุม

คุณใช้การจัดช่องควบคุมเพื่อเพิ่มตัวควบคุมแบบ HTML ลงในแผนที่ได้ ช่องคือตำแหน่งที่กำหนดไว้ล่วงหน้าบนแผนที่ ใช้แอตทริบิวต์ slot เพื่อตั้งค่าตำแหน่งที่ต้องการสำหรับองค์ประกอบ และซ้อนองค์ประกอบภายในองค์ประกอบ gmp-map ข้อมูลโค้ดต่อไปนี้แสดงการเพิ่มป้ายกำกับ HTML ที่มุมซ้ายบนของ แผนที่

<!-- The map, centered at Uluru, Australia. -->
<gmp-map center="-25.344,131.031" zoom="4" map-id="DEMO_MAP_ID">
  <div id="controls" slot="control-inline-start-block-start">
    <h3>My Google Maps Demo</h3>
  </div>
</gmp-map>

ขั้นตอนที่ 3: เพิ่มโค้ด JavaScript

ส่วนนี้จะแสดงวิธีโหลด Maps JavaScript API ลงในหน้าเว็บ และวิธีเขียน JavaScript ของคุณเองที่ใช้ API เพื่อเพิ่มแผนที่ที่มีเครื่องหมาย

TypeScript

async function initMap(): Promise<void> {
  //  Request the needed libraries.
  const [{ Map }, { AdvancedMarkerElement }] = await Promise.all([
    google.maps.importLibrary("maps") as Promise<google.maps.MapsLibrary>,
    google.maps.importLibrary("marker") as Promise<google.maps.MarkerLibrary>,
  ]);
  // Get the gmp-map element.
  const mapElement = document.querySelector(
    "gmp-map"
  ) as google.maps.MapElement;

  // Get the inner map.
  const innerMap = mapElement.innerMap;

  // Set map options.
  innerMap.setOptions({
    mapTypeControl: false,
  });

  // Add a marker positioned at the map center (Uluru).
  const marker = new AdvancedMarkerElement({
    map: innerMap,
    position: mapElement.center,
    title: "Uluru/Ayers Rock",
  });
}
initMap();

JavaScript

async function initMap() {
    //  Request the needed libraries.
    const [{ Map }, { AdvancedMarkerElement }] = await Promise.all([
        google.maps.importLibrary("maps"),
        google.maps.importLibrary("marker"),
    ]);
    // Get the gmp-map element.
    const mapElement = document.querySelector("gmp-map");
    // Get the inner map.
    const innerMap = mapElement.innerMap;
    // Set map options.
    innerMap.setOptions({
        mapTypeControl: false,
    });
    // Add a marker positioned at the map center (Uluru).
    const marker = new AdvancedMarkerElement({
        map: innerMap,
        position: mapElement.center,
        title: "Uluru/Ayers Rock",
    });
}
initMap();

โค้ดข้างต้นจะทำสิ่งต่อไปนี้เมื่อมีการเรียกใช้ initMap()

  • โหลดไลบรารี maps และ marker
  • รับองค์ประกอบแผนที่จาก DOM
  • ตั้งค่าตัวเลือกแผนที่เพิ่มเติม ในแผนที่ด้านใน
  • เพิ่มเครื่องหมายลงในแผนที่

รับออบเจ็กต์แผนที่และตั้งค่าตัวเลือก

innerMap แสดงอินสแตนซ์ของคลาส Map หากต้องการตั้งค่าตัวเลือกแผนที่ ให้รับอินสแตนซ์ innerMap จากองค์ประกอบแผนที่ แล้วเรียกใช้ setOptions ข้อมูลโค้ดต่อไปนี้แสดงการรับอินสแตนซ์ innerMap จาก DOM แล้วเรียกใช้ setOptions

// Get the gmp-map element.
const mapElement = document.querySelector(
  "gmp-map"
) as google.maps.MapElement;

// Get the inner map.
const innerMap = mapElement.innerMap;

// Set map options.
innerMap.setOptions({
  mapTypeControl: false,
});

รอให้แผนที่โหลด

เมื่อใช้องค์ประกอบ gmp-map แผนที่จะโหลดแบบไม่พร้อมกัน ซึ่งอาจส่งผลให้เกิดสภาวะการแข่งขันหากมีการส่งคำขออื่นๆ ในเวลาเริ่มต้น (เช่น คำขอตำแหน่งทางภูมิศาสตร์หรือคำขอรายละเอียดสถานที่) หากต้องการให้โค้ดทำงานหลังจากโหลดแผนที่เสร็จสมบูรณ์แล้วเท่านั้น ให้ใช้addListenerOnceตัวแฮนเดิลเหตุการณ์ที่ไม่ได้ใช้งาน ในฟังก์ชันการเริ่มต้น ดังที่แสดงที่นี่

// Do things once the map has loaded.
google.maps.event.addListenerOnce(innerMap, 'idle', () => {
    // Run this code only after the map has loaded.
    console.log("The map is now ready!");
});

การทำเช่นนี้จะช่วยให้มั่นใจได้ว่าโค้ดจะทำงานหลังจากโหลดแผนที่แล้วเท่านั้น และ handler จะทริกเกอร์เพียงครั้งเดียวในวงจรของแอป

โค้ดตัวอย่างที่สมบูรณ์

ดูโค้ดตัวอย่างที่สมบูรณ์ได้ที่นี่

TypeScript

async function initMap(): Promise<void> {
  //  Request the needed libraries.
  const [{ Map }, { AdvancedMarkerElement }] = await Promise.all([
    google.maps.importLibrary("maps") as Promise<google.maps.MapsLibrary>,
    google.maps.importLibrary("marker") as Promise<google.maps.MarkerLibrary>,
  ]);
  // Get the gmp-map element.
  const mapElement = document.querySelector(
    "gmp-map"
  ) as google.maps.MapElement;

  // Get the inner map.
  const innerMap = mapElement.innerMap;

  // Set map options.
  innerMap.setOptions({
    mapTypeControl: false,
  });

  // Add a marker positioned at the map center (Uluru).
  const marker = new AdvancedMarkerElement({
    map: innerMap,
    position: mapElement.center,
    title: "Uluru/Ayers Rock",
  });
}
initMap();

JavaScript

async function initMap() {
    //  Request the needed libraries.
    const [{ Map }, { AdvancedMarkerElement }] = await Promise.all([
        google.maps.importLibrary("maps"),
        google.maps.importLibrary("marker"),
    ]);
    // Get the gmp-map element.
    const mapElement = document.querySelector("gmp-map");
    // Get the inner map.
    const innerMap = mapElement.innerMap;
    // Set map options.
    innerMap.setOptions({
        mapTypeControl: false,
    });
    // Add a marker positioned at the map center (Uluru).
    const marker = new AdvancedMarkerElement({
        map: innerMap,
        position: mapElement.center,
        title: "Uluru/Ayers Rock",
    });
}
initMap();

CSS

/*
 * Always set the map height explicitly to define the size of the div element
 * that contains the map.
 */
gmp-map {
  height: 100%;
}

/*
   * Optional: Makes the sample page fill the window.
   */
html,
body {
  height: 100%;
  margin: 0;
  padding: 0;
}

HTML

<html>
  <head>
    <title>Add a Map</title>

    <link rel="stylesheet" type="text/css" href="./style.css" />
    <script type="module" src="./index.js"></script>
    <!-- prettier-ignore -->
    <script>(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})
        ({key: "AIzaSyA6myHzS10YXdcazAFalmXvDkrYCp5cLc8", v: "weekly"});</script>
  </head>
  <body>
    <!-- The map, centered at Uluru, Australia. -->
    <gmp-map center="-25.344,131.031" zoom="4" map-id="DEMO_MAP_ID">
      <div id="controls" slot="control-inline-start-block-start">
        <h3>My Google Maps Demo</h3>
      </div>
    </gmp-map>
  </body>
</html>

ลองใช้ตัวอย่าง

ดูข้อมูลเพิ่มเติมเกี่ยวกับเครื่องหมาย

เคล็ดลับและการแก้ปัญหา

  • ดูข้อมูลเพิ่มเติมเกี่ยวกับการรับพิกัดละติจูด/ลองจิจูด หรือการแปลงที่อยู่เป็นพิกัดทางภูมิศาสตร์
  • คุณสามารถปรับแต่งตัวเลือกต่างๆ เช่น สไตล์และพร็อพเพอร์ตี้ เพื่อปรับแต่งแผนที่ ดูข้อมูลเพิ่มเติมเกี่ยวกับการปรับแต่งแผนที่ได้ที่คำแนะนำเกี่ยวกับการจัดรูปแบบและการวาดบนแผนที่
  • ใช้คอนโซลเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ในเว็บเบราว์เซอร์เพื่อทดสอบและเรียกใช้โค้ด อ่านรายงานข้อผิดพลาด และแก้ปัญหาเกี่ยวกับโค้ด
  • ใช้แป้นพิมพ์ลัดต่อไปนี้เพื่อเปิดคอนโซลใน Chrome
    Command+Option+J (ใน Mac) หรือ Control+Shift+J (ใน Windows)
  • ทำตามขั้นตอนด้านล่างเพื่อดูพิกัดละติจูดและ ลองจิจูดของสถานที่ใน Google Maps

    1. เปิด Google Maps ในเบราว์เซอร์
    2. คลิกขวาที่ตำแหน่งที่แน่นอนบนแผนที่ที่คุณต้องการ พิกัด
    3. เลือกที่นี่คือที่ไหนจากเมนูตามบริบทที่ปรากฏขึ้น แผนที่จะแสดงการ์ดที่ด้านล่างของหน้าจอ ค้นหาพิกัดละติจูด และลองจิจูดในแถวสุดท้ายของการ์ด
  • คุณแปลงที่อยู่เป็นพิกัดละติจูดและลองจิจูดได้โดยใช้ บริการ Geocoding คู่มือนักพัฒนาแอปมีข้อมูลโดยละเอียดเกี่ยวกับการเริ่มต้นใช้งานบริการ Geocoding