นโยบายสำหรับ Places SDK สำหรับ Android

หัวข้อนี้จะอธิบายข้อกำหนดการระบุแหล่งที่มาสำหรับแอปพลิเคชันทั้งหมด ที่พัฒนาด้วย Places SDK สำหรับ Android ซึ่งรวมถึงบริการ Place Autocomplete ที่เป็นส่วนหนึ่งของ API นั้น ดูข้อกำหนดอื่นๆ ของ Google Maps Platform ได้ที่ข้อกำหนดในการให้บริการของ Google Maps Platform

นโยบาย

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

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

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

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

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

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

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

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

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

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

ชุดเครื่องมือ UI ของ Places
ตัวอย่างการระบุแหล่งที่มาในแผนที่ที่ไม่ใช่ของ Google
การระบุแหล่งที่มาที่จำเป็นซึ่งใช้กับคอมโพเนนต์ขนาดกะทัดรัดของรายละเอียดสถานที่ ในแผนที่ที่ไม่ใช่ของ 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

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

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

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

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

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

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

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

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

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

API จะแสดงออบเจ็กต์ Place หากต้องการดึงการระบุแหล่งที่มาจากออบเจ็กต์ Place ให้เรียกใช้ Place.getAttributions() เมธอดจะแสดงผล List ของออบเจ็กต์ String หรือ null หากไม่มีการระบุแหล่งที่มาที่จะแสดง

String placeId = "INSERT_PLACE_ID_HERE";
List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME);
FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
  Place place = response.getPlace();
  textView.append("Place found: " + place.getName());
  List<String> attributions = place.getAttributions();
  if (attributions != null) {
    StringBuilder stringBuilder = new StringBuilder("Attributions: ");
    for (String attribution : attributions) {
      stringBuilder.append(attribution).append("\n");
    }
    textView.append(stringBuilder.toString());
  }}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
      // Handle the error.
    }
  }
);

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

หากแอปแสดงรูปภาพสถานที่ คุณต้อง แสดงการระบุแหล่งที่มาสำหรับรูปภาพแต่ละรูปที่มีการระบุแหล่งที่มา PhotoMetadata สามารถมีการระบุแหล่งที่มาได้ 2 ประเภท ได้แก่

หากต้องการรับการระบุแหล่งที่มาของสตริงสำหรับรูปภาพ ให้เรียกใช้ PhotoMetadata.getAttributions() เมธอดจะแสดงลำดับอักขระ HTML หรือสตริงว่างหากไม่มีการระบุแหล่งที่มาที่จะแสดง

// Get the photo metadata from the Place object.
PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0);

// Get the attribution text.
String attributions = photoMetadata.getAttributions();

หากต้องการดูการระบุแหล่งที่มาของผู้แต่งสำหรับรูปภาพ ให้เรียกใช้ PhotoMetadata.getAuthorAttributions() เมธอดจะแสดงผลออบเจ็กต์ AuthorAttributions ออบเจ็กต์นี้มี List ของออบเจ็กต์ AuthorAttribution โดยมี 1 รายการต่อการระบุแหล่งที่มาของผู้เขียน 1 ราย

// Get the photo metadata from the Place object.
PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0);

// Get the author attributions object.
AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions();
List<AuthorAttribution> authorAttributionList = authorAttributions.asList();

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

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

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

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

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

ปุ่ม 2: ตกลง

แสดงรีวิว

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

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

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

นอกจากนี้ Google ยังขอแนะนำให้คุณแสดงวิธีจัดเรียงรีวิวต่อผู้ใช้ปลายทางด้วย

หากต้องการเข้าถึงรีวิว ให้โทรหา Place.getReviews()

// Specify the fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.REVIEWS);

// Construct a request object, passing the place ID and fields array.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance("INSERT_PLACE_ID_HERE", placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
    Place place = response.getPlace();
    List<Review> reviews = place.getReviews();
    // For loop for iterating over the List
    for (int i = 0; i < reviews.size(); i++) {
      // For each review, get the Review object.
        Review placeReview = reviews.get(i);

      // Get any attribution and author attribution.
        String reviewAttribution = placeReview.getAttribution();
        AuthorAttribution authorAttribution = placeReview.getAuthorAttribution();

        // Display the review contents and attributions as necessary.
    }
}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
        // Handle the error.
    }
});

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

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

API จะสร้างการระบุแหล่งที่มาสำหรับสถานที่ทั้งหมดที่แอปใช้ การระบุแหล่งที่มาจะระบุต่อการเรียก API ไม่ใช่ต่อสถานที่

วิธีหนึ่งในการแสดงการระบุแหล่งที่มาคือการใช้ TextView เช่น

TextView attributionsText = (TextView) findViewById(R.id.attributions);
String thirdPartyAttributions = place.getAttributions();
attributionsText.setText(thirdPartyAttributions);

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

Listings by <a href="https://www.example.com/">Example Company</a>

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

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

เติมที่อยู่ของผู้ใช้ปลายทางอัตโนมัติ

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