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

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

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

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

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

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.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 ประเภทดังนี้

• Attributions ซึ่งเป็นสตริงการระบุแหล่งที่มาที่ 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();

แสดงรีวิว

ออบเจ็กต์ 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 Gray 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 ตัวอย่าง

เมื่อใช้ 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;