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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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;