หัวข้อนี้แสดงข้อกำหนดการระบุแหล่งที่มาสำหรับแอปพลิเคชันทั้งหมดที่พัฒนาด้วย 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 ต่อไปนี้
- ข้อกำหนดในการให้บริการของ Google Maps Platform สำหรับ EEA
- ข้อกำหนดเฉพาะของบริการ Google Maps Platform ใน EEA
- คำถามที่พบบ่อย (FAQ) เกี่ยวกับ EEA
- ข้อกำหนดด้านความปลอดภัยบนท้องถนนของ Google Maps Platform
หากที่อยู่สำหรับการเรียกเก็บเงินไม่ได้อยู่ใน EEA ข้อกำหนดในการให้บริการต่อไปนี้จะมีผลบังคับใช้กับคุณ
ข้อกำหนดในการระบุแหล่งที่มาของ Google Maps
ส่วนนี้จะอธิบายข้อกำหนดและหลักเกณฑ์การระบุแหล่งที่มาสำหรับการแสดง Google Maps และเนื้อหาผ่านแอปพลิเคชันของคุณ
ตัวอย่างการระบุแหล่งที่มา
ต่อไปนี้คือตัวอย่างการระบุแหล่งที่มาสำหรับ Places UI Kit
แสดงการระบุแหล่งที่มาของ 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- ความสูงขั้นต่ำของโลโก้: 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 โดยใช้แอตทริบิวต์ HTML
translate="no"
จัดรูปแบบข้อความ 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 สำหรับผลิตภัณฑ์บางอย่าง เช่น 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 ประเภท ได้แก่
- 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();
การระบุแหล่งที่มาของผลการค้นหา
ในยุโรป เมื่อใช้การจัดอันดับที่ไม่มีการปรับแต่งของ 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 ข้อยกเว้นนี้ไม่มีผลกับฟังก์ชันการค้นหาจุดที่น่าสนใจหรือที่อยู่ซึ่งให้บริการโดยบริการอื่นๆ ของ Google Maps Platform

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