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

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

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

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

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

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

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

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

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

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

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

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

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

การแสดงผล Maps JavaScript API

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

หากแอปพลิเคชันของคุณแสดงข้อมูลบน Google แผนที่ บัญชี 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: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen, 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

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

พื้นที่ว่าง

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

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

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

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

สี

ใช้ข้อความ Google Material Gray 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 ตัวอย่าง

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;