นโยบายสำหรับ Maps JavaScript API

หัวข้อนี้จะระบุข้อกำหนดในการระบุแหล่งที่มาสำหรับแอปพลิเคชันทั้งหมดที่พัฒนาขึ้นด้วย Maps JavaScript API รวมถึงบริการการเติมข้อความอัตโนมัติของสถานที่ซึ่งเป็นส่วนหนึ่งของ API ดังกล่าว ดูข้อกำหนดเพิ่มเติมของ Google Maps Platform ได้ที่ข้อกำหนดในการให้บริการของ Google Maps Platform

ให้ข้อกำหนดในการใช้งานและนโยบายความเป็นส่วนตัว

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

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

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

แอปพลิเคชันบนอุปกรณ์เคลื่อนที่

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

เว็บแอปพลิเคชัน

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

การดึงข้อมูลล่วงหน้า การแคช หรือการจัดเก็บเนื้อหา

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

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

การแสดงผลลัพธ์ของ Maps JavaScript API

คุณสามารถแสดงผลลัพธ์ Maps JavaScript API ใน Google Maps หรือจะแสดงโดยไม่มีแผนที่ก็ได้ หากต้องการแสดงผลการค้นหา Maps JavaScript API ในแผนที่ ผลการค้นหาเหล่านี้จะต้องแสดงใน Google Maps ห้ามใช้ข้อมูล Maps JavaScript API ในแผนที่ที่ไม่ใช่แผนที่ของ Google

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

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

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

ตำแหน่งการระบุแหล่งที่มาของนโยบาย

ไฟล์ ZIP ต่อไปนี้มีโลโก้ Google ในขนาดที่ถูกต้องสำหรับแอปพลิเคชันบนเดสก์ท็อป, Android และ iOS คุณต้องไม่ปรับขนาดหรือแก้ไขโลโก้ ไม่ว่าในลักษณะใดก็ตาม

ดาวน์โหลด: google_logo.zip

อย่าแก้ไขการระบุแหล่งที่มา อย่านำข้อมูลระบุแหล่งที่มาออก ปิดบัง หรือครอบตัด คุณไม่สามารถใช้โลโก้ Google ในบรรทัดได้ (เช่น "แผนที่เหล่านี้มาจาก [Google_logo]")

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

ระบุผู้ให้บริการข้อมูลจากบุคคลที่สาม ข้อมูลและรูปภาพบางส่วนในผลิตภัณฑ์การแมปของเรามาจากผู้ให้บริการที่ไม่ใช่ Google หากใช้ภาพดังกล่าว ข้อความระบุแหล่งที่มาต้องระบุชื่อ "Google" และผู้ให้บริการข้อมูลที่เกี่ยวข้อง เช่น "ข้อมูลแผนที่: Google, Maxar Technologies" เมื่อมีการระบุผู้ให้บริการข้อมูลบุคคลที่สามในภาพ การให้เครดิตเพียง "Google" หรือโลโก้ Google เท่านั้นนั้นไม่ถูกต้อง

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

ข้อกำหนดอื่นๆ ในการระบุแหล่งที่มา

ทําตามวิธีการเหล่านี้เพื่อดึงข้อมูลการระบุแหล่งที่มาของบุคคลที่สาม และเพื่อแสดงการระบุแหล่งที่มาในแอป

เรียกข้อมูลระบุแหล่งที่มาจากสถานที่

หากแอปแสดงข้อมูลรีวิวที่ได้จากการเรียกใช้ Place.fetchFields แอปจะต้องแสดงการระบุแหล่งที่มาของบุคคลที่สามสำหรับรายละเอียดสถานที่ที่ได้รับด้วย

API จะแสดงผลออบเจ็กต์ Place หากต้องการดึงข้อมูลการระบุแหล่งที่มาจากออบเจ็กต์ Place ให้ใช้พร็อพเพอร์ตี้ Place.attributions ซึ่งจะแสดงผลพร้อมทุกคำขอ (ไม่จำเป็นต้องระบุด้วยช่อง) พร็อพเพอร์ตี้จะแสดงผลออบเจ็กต์ List จาก String รายการ หรือ null หากไม่มีการระบุแหล่งที่มาที่จะแสดง โค้ดตัวอย่างต่อไปนี้แสดงการรับสถานที่และแสดงการระบุแหล่งที่มา

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen
  });

  // Call fetchFields, passing the desired data fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // Check for any place attributions.
  if (!place.attributions) {
      console.log('No attributions were found.');
      return;
  } else {
      // Log the place attribution
      for (var attribution of place.attributions) {
          console.log(attribution);
      }
  }

แสดงรีวิว

ออบเจ็กต์ Place อาจมีรีวิวได้สูงสุด 5 รายการ โดยรีวิวแต่ละรายการจะแสดงโดยออบเจ็กต์ Review คุณเลือกที่จะแสดงรีวิวเหล่านี้ในแอปหรือไม่ก็ได้

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

การแสดงการระบุแหล่งที่มาของผู้เขียน

ตัวอย่างต่อไปนี้แสดงการเรียกดูสถานที่ การตรวจสอบรีวิว และการแสดงข้อมูลจากรีวิวแรก 

  // Use place ID to create a new Place instance.
  const place = new Place({
    id: "ChIJpyiwa4Zw44kRBQSGWKv4wgA", // Faneuil Hall Marketplace, Boston, MA
  });

  // Call fetchFields, passing "reviews" and other needed fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // If there are any reviews display the first one.
  if (!place.reviews) {
      console.log('No reviews were found.');
  } else {
      // Log the review count so we can see how many there are.
      console.log("REVIEW COUNT: " + place.reviews.length);

      // Get info for the first review.
      let reviewRating = place.reviews[0].rating;
      let reviewText = place.reviews[0].text;
      let authorName = place.reviews[0].authorAttribution.displayName;
      let authorUri = place.reviews[0].authorAttribution.uri;

      // Create a bit of HTML to add to the info window
      const contentString =
        '<div id="title"><b>' + place.displayName + '</b></div>' +
        '<div id="address">' + place.formattedAddress + '</div>' +
        '<a href="' + authorUri + '" target="_blank">Author: ' + authorName + '</a>' +
        '<div id="rating">Rating: ' + reviewRating + ' stars</div>' +
        '<div id="rating""><p>Review: ' + reviewText + '</p></div>';

      // Create an info window.
      infoWindow = new InfoWindow({
          content: contentString,
          ariaLabel: place.displayName,
      });

      // Add a marker for the place.
      const marker = new AdvancedMarkerElement({
          map,
          position: place.location,
          title: place.displayName,
      });

      // Show the info window.
      infoWindow.open({
          anchor: marker,
          map,
      });
  }

ดูเอกสารประกอบสำหรับรีวิวสถานที่

แสดงการระบุแหล่งที่มาของรูปภาพ

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

องค์ประกอบแต่ละรายการของอาร์เรย์รูปภาพเป็นอินสแตนซ์ของ Photo ซึ่งมีอาร์เรย์ authorAttributions ประเภท AuthorAttribution ฟิลด์ของออบเจ็กต์ AuthorAttribution คือสตริงที่มี displayName, uri และ photoUri ของการระบุแหล่งที่มา หรือสตริงว่างหากไม่มีการระบุแหล่งที่มาที่จะแสดง

ดูเอกสารประกอบสำหรับรูปภาพสถานที่

การระบุแหล่งที่มาของผลการค้นหา

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

ส่วนหัว: เกี่ยวกับผลการค้นหาเหล่านี้

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

ปุ่มที่ 1: ดูข้อมูลเพิ่มเติม
ข้อความ "ดูข้อมูลเพิ่มเติม" ควรลิงก์ไปยังบทความในศูนย์ช่วยเหลือ

ปุ่ม 2: ตกลง

หลักเกณฑ์ด้านรูปแบบการระบุแหล่งที่มาของ Google

ต่อไปนี้คือหลักเกณฑ์ด้านรูปแบบสำหรับการระบุแหล่งที่มาของ Google ใน CSS และ HTML หากคุณไม่สามารถใช้โลโก้ Google ที่ดาวน์โหลดได้

พื้นที่ว่าง

พื้นที่ว่างรอบๆ โลโก้ตัวเต็มควรเท่ากับหรือมากกว่าความสูงของ "G" ใน Google

พื้นที่ว่างระหว่างข้อความระบุแหล่งที่มาและโลโก้ Google ควรเป็นครึ่งหนึ่งของความกว้างของ "G"

ความอ่านง่าย

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

สี

ใช้ข้อความ Google Material Grey 700 บนพื้นหลังสีขาวหรือสีอ่อนซึ่งเจือเฉดสีดำที่มีความเข้ม 0%–40%

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

ใช้ข้อความสีขาวสำหรับเครดิตและชื่อผู้แต่งบนพื้นหลังสีเข้ม รวมถึงบนรูปภาพหรือลวดลายที่ไม่ซับซ้อน

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

แบบอักษร

ใช้แบบอักษร Roboto

ตัวอย่าง CSS

เมื่อใช้กับข้อความ "Google" ข้อความ "Google" จะแสดงผลด้วยแบบอักษร สี และระยะห่างที่เหมาะสมบนพื้นหลังสีขาวหรืออ่อน

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;