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

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

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

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

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

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

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

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

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

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

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

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

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

การแสดงผลลัพธ์ของ Places SDK สำหรับ Android

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

การแสดงโลโก้และการระบุแหล่งที่มาของ 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 เพื่อพูดคุยเกี่ยวกับใบอนุญาตที่เหมาะสมกับกรณีการใช้งานของคุณ

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

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

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

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

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

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 อาจมีการระบุแหล่งที่มา 1 ใน 2 ประเภทต่อไปนี้

• การระบุแหล่งที่มา ซึ่งเป็นสตริงการระบุแหล่งที่มาที่ PhotoMetadata.getAttributions() เข้าถึง
• AuthorAttributions ซึ่งเป็นออบเจ็กต์ AuthorAttributions ที่เข้าถึงโดย PhotoMetadata.getAuthorAttributions()

หากต้องการดูการระบุแหล่งที่มาของสตริงสําหรับรูปภาพ ให้เรียกใช้ 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 รายการต่อการระบุแหล่งที่มาของผู้แต่ง

// 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 แบบไม่เปลี่ยนแปลง ผลิตภัณฑ์การค้นหาต้องมีข้อความอธิบายที่คลิกได้ไม่เกิน 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

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

พื้นที่ว่าง

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

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

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

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

สี

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

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

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

#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;