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

เอกสารนี้แสดงข้อกำหนดสำหรับแอปพลิเคชันที่พัฒนาด้วย Maps JavaScript API โปรดทราบว่าการใช้ Maps JavaScript API อยู่ภายใต้ข้อตกลงของคุณกับ Google

นโยบาย

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

ข้อยกเว้นจากข้อจำกัดในการแคช

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

การคัดลอกเนื้อหา

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

ประเทศและเขตแดนในเขตเศรษฐกิจยุโรป

ผลิตภัณฑ์นี้มีข้อกำหนดในการให้บริการที่แตกต่างกันสำหรับลูกค้าที่มีที่อยู่สำหรับการเรียกเก็บเงินใน เขตเศรษฐกิจยุโรป (EEA) และอาจมีฟังก์ชันการทำงานที่แตกต่างกันด้วย ก่อนสร้างด้วย Google Maps Platform โปรดอ่านข้อกำหนดและข้อมูลต่อไปนี้สำหรับ EEA โดยเฉพาะ

• ข้อกำหนดในการให้บริการของ Google Maps Platform ใน EEA
• ข้อกำหนดเฉพาะของบริการ Google Maps Platform ในเขตเศรษฐกิจยุโรป
• คำถามที่พบบ่อยเกี่ยวกับ EEA
• ข้อกำหนดด้านความปลอดภัยบนท้องถนนของ Google Maps Platform

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

• ข้อกำหนดในการให้บริการของแพลตฟอร์ม Google Maps
• ข้อกำหนดเฉพาะของบริการ Google Maps Platform

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

ส่วนนี้จะระบุข้อกำหนดในการระบุแหล่งที่มาและหลักเกณฑ์สำหรับการแสดง Google Maps และเนื้อหาผ่านแอปพลิเคชันของคุณ

ตัวอย่างการระบุแหล่งที่มา

ต่อไปนี้เป็นตัวอย่างการระบุแหล่งที่มาสำหรับ Places UI Kit

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

แสดงการระบุแหล่งที่มาของ Google Maps

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

การระบุแหล่งที่มาของ Google Maps ที่รวมไว้

สำหรับการระบุแหล่งที่มาของ Google Maps ที่ Google Maps Platform มีให้ใน อินเทอร์เฟซผู้ใช้แล้ว เช่น ใน Places UI Kit ให้ทำดังนี้

• อย่านำการระบุแหล่งที่มาที่รวมไว้ออกไม่ว่าจะแสดงที่ใดก็ตาม ห้ามดัดแปลง ซ่อน หรือปิดบังการระบุแหล่งที่มา และตรวจสอบว่าการระบุแหล่งที่มามองเห็นได้ชัดเจนบนพื้นหลัง
• แยกความแตกต่างของเนื้อหา Google Maps Platform จากเนื้อหาอื่นๆ ด้วยการใช้คำแนะนำใน UI เช่น เส้นขอบ สีพื้นหลัง เงา หรือพื้นที่ว่างที่เพียงพอ
• เมื่อทำการแก้ไขภาพ คุณต้องปฏิบัติตามข้อกำหนดการระบุแหล่งที่มาของ Google Maps ทั้งหมด

โลโก้ Google Maps และการระบุแหล่งที่มาด้วยข้อความ

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

ซ้าย: การระบุแหล่งที่มาของโลโก้ Google Maps, ขวา: การระบุแหล่งที่มาของข้อความ Google Maps

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

ทำตามข้อกำหนดต่อไปนี้สำหรับการใช้โลโก้ Google Maps ในแอปหรือเว็บไซต์

รูปแบบที่ยอมรับได้สำหรับการระบุแหล่งที่มาของโลโก้ Google Maps

ดาวน์โหลดโลโก้ Google Maps

ใช้ไฟล์โลโก้ Google Maps อย่างเป็นทางการ ดาวน์โหลดโลโก้ด้านล่างและปฏิบัติตามหลักเกณฑ์ในส่วนนี้

ดาวน์โหลดชิ้นงานการระบุแหล่งที่มาของ Google Maps

เมื่อใช้โลโก้ Google Maps โปรดปฏิบัติตามหลักเกณฑ์ต่อไปนี้

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

ข้อกำหนดขนาดโลโก้

ปฏิบัติตามข้อกำหนดด้านขนาดต่อไปนี้สำหรับโลโก้ Google Maps

• ความสูงขั้นต่ำของโลโก้: 16dp
• ความสูงของโลโก้สูงสุด: 19dp
• พื้นที่ว่างขั้นต่ำของโลโก้: 10dp ทางด้านซ้าย ขวา และด้านบน 5dp ทางด้านล่าง

ดูข้อมูลเกี่ยวกับ dp ได้ที่ความหนาแน่นของพิกเซลในเว็บไซต์ Material Design

โลโก้ Google Maps ที่แสดงพื้นที่ว่างขั้นต่ำและช่วงขนาดที่ยอมรับได้

การเข้าถึงโลโก้

ทำตามข้อกำหนดด้านการช่วยเหลือพิเศษต่อไปนี้สำหรับโลโก้ Google Maps

• รักษาระดับความคมชัดที่เข้าถึงได้ระหว่างโลโก้กับพื้นหลัง
• ระบุป้ายกำกับการช่วยเหลือพิเศษพร้อมข้อความ Google Maps

รูปแบบที่ไม่ยอมรับและปัญหาด้านการช่วยเหลือพิเศษสำหรับการระบุแหล่งที่มาของโลโก้ Google Maps

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

หากขนาดของอินเทอร์เฟซไม่รองรับการใช้โลโก้ Google Maps คุณสามารถสะกด Google Maps เป็นข้อความได้ ปฏิบัติตามหลักเกณฑ์ต่อไปนี้:

รูปแบบที่ยอมรับได้ของการระบุแหล่งที่มาของข้อความ Google Maps

• โปรดอย่าแก้ไขข้อความ Google Maps ในลักษณะใดก็ตาม
  
  • อย่าเปลี่ยนการใช้อักษรตัวพิมพ์ของ Google Maps
  • อย่าวาง Google Maps ในหลายบรรทัด
  • อย่าแปล Google Maps เป็นภาษาอื่น
  • ป้องกันไม่ให้เบราว์เซอร์แปล Google Maps โดยใช้แอตทริบิวต์ HTML translate="no"

การดัดแปลงข้อความระบุแหล่งที่มาของ Google Maps ที่ไม่ยอมรับ

• จัดรูปแบบข้อความ Google Maps ตามที่อธิบายไว้ในตารางต่อไปนี้

  ข้อกำหนดการจัดรูปแบบข้อความของ Google Maps
  พร็อพเพอร์ตี้	สไตล์
  ชุดแบบอักษร	Roboto คุณจะโหลดฟอนต์หรือไม่ก็ได้
  ชุดแบบอักษรสำรอง	แบบอักษรเนื้อหาแบบ Sans Serif ที่ใช้ในผลิตภัณฑ์อยู่แล้ว หรือ "Sans-Serif" เพื่อเรียกใช้แบบอักษรเริ่มต้นของระบบ
  รูปแบบอักษร	ปกติ
  น้ำหนักแบบอักษร	400
  สีแบบอักษร	สีขาว สีดำ (#1F1F1F) หรือสีเทา (#5E5E5E) รักษาคอนทราสต์ที่เข้าถึงได้ (4.5:1) กับพื้นหลัง
  ขนาดแบบอักษร	ขนาดแบบอักษรขั้นต่ำ: 12sp ขนาดแบบอักษรสูงสุด: 16sp ดูข้อมูลเกี่ยวกับ sp ได้ที่หน่วยขนาดแบบอักษรในเว็บไซต์ Material Design
  ระยะห่างระหว่างตัวอักษร	ปกติ

ตัวอย่าง CSS

CSS ต่อไปนี้จะแสดงผล Google Maps ด้วยรูปแบบการพิมพ์และสีที่เหมาะสมบนพื้นหลังสีขาวหรือสีอ่อน

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

ข้อกำหนดด้านภาพ

ปฏิบัติตามข้อกำหนดต่อไปนี้สำหรับการแสดงภาพของการระบุแหล่งที่มาของ Google Maps

• วางตําแหน่งการระบุแหล่งที่มาไว้ใกล้กับด้านบนหรือด้านล่างของเนื้อหา และภายในคอนเทนเนอร์ภาพเดียวกัน สําหรับเนื้อหาบรรทัดเดียว คุณสามารถวางตําแหน่งการระบุแหล่งที่มาทางด้านขวาหรือซ้ายได้

• แยกความแตกต่างของเนื้อหา Google Maps Platform จากเนื้อหาอื่นๆ ด้วยการใช้คำแนะนำใน UI เช่น เส้นขอบ สีพื้นหลัง เงา หรือพื้นที่ว่างที่เพียงพอ

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

ภาพต่อไปนี้แสดงตัวอย่างข้อกำหนดด้านภาพเหล่านี้

ตัวอย่างการระบุแหล่งที่มาของ Google Maps ที่วางไว้ด้านบน ด้านล่าง และด้านข้างของเนื้อหา

ตัวอย่างแนวทาง 3 วิธีในการแยกความแตกต่างของเนื้อหา Google Maps (การจัดอันดับสถานที่) จากเนื้อหาอื่นๆ

อย่าบดบังการระบุแหล่งที่มาของ Google Maps หรือนำไปปะปนกับเนื้อหาจากแหล่งที่มาอื่นๆ

ผู้ให้บริการข้อมูลบุคคลที่สาม

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

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

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

รีวิวและรูปภาพที่ระบุผ่าน Maps JavaScript API จะ ขึ้นอยู่กับนโยบายเนื้อหาและผลิตภัณฑ์ของ Google ไม่ว่าคุณจะอยู่ที่ใดในโลก หากต้องการรายงานเนื้อหาที่คุณหรือผู้ใช้ต้องการให้นำออกจากบริการของ Google ภายใต้นโยบายของ Google หรือกฎหมายที่เกี่ยวข้อง โปรดดูรายงานเนื้อหาใน 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 ผลิตภัณฑ์ Search ต้องมีข้อความอธิบายที่อยู่ห่างออกไปไม่เกิน 1 คลิก ซึ่งอธิบายปัจจัยหลักและน้ำหนักของปัจจัยหลักที่กำหนดการจัดอันดับผลการค้นหา ข้อความอธิบาย:

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

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

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

ปุ่ม 2: ตกลง

การเติมข้อความอัตโนมัติสำหรับที่อยู่ของผู้ใช้ปลายทาง

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

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