เอกสารนี้แสดงข้อกำหนดเฉพาะสำหรับแอปพลิเคชันทั้งหมดที่พัฒนาด้วย Places SDK สำหรับ iOS รวมถึงบริการ Place Autocomplete ซึ่งเป็นส่วนหนึ่งของ API นั้น ดูข้อมูลทั่วไปเพิ่มเติมสำหรับนักพัฒนาซอฟต์แวร์ Google Maps ได้ที่ข้อกำหนดในการให้บริการของ Google Maps Platform
นโยบาย
ส่วนนี้จะอธิบายถึงนโยบายที่เกี่ยวข้องกับ Places SDK สำหรับ iOS นโยบายมีหลักเกณฑ์และข้อกำหนดในการใช้งานจริงเพื่อช่วยให้คุณใช้บริการได้อย่างถูกต้องและสอดคล้องกับความคาดหวังของ 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 ไม่ถือเป็นการระบุแหล่งที่มาที่เหมาะสม
ข้อกำหนดอื่นๆ ในการระบุแหล่งที่มา
การระบุแหล่งที่มาของผู้ให้บริการบุคคลที่สามมีเนื้อหาและลิงก์ที่คุณต้องแสดงต่อผู้ใช้ในรูปแบบที่ระบุไว้ Google แนะนำให้แอปแสดงข้อมูลนี้ใต้รายละเอียดสถานที่
การระบุแหล่งที่มาของบุคคลที่สามที่ API แสดงผลจะไม่รวมการระบุแหล่งที่มาของ Google คุณต้องใส่การระบุแหล่งที่มานี้ด้วยตนเองตามที่อธิบายไว้ในการแสดงโลโก้ Google และการระบุแหล่งที่มา
ทำตามวิธีการเหล่านี้เพื่อดึงข้อมูลการระบุแหล่งที่มาของบุคคลที่สามสำหรับสถานที่เดียวหรือคอลเล็กชันสถานที่
ดึงข้อมูลการระบุแหล่งที่มาของสถานที่เดียว
เมื่อคุณดึงข้อมูลสถานที่โดยการรับสถานที่ตามรหัส คุณจะดึงข้อมูลการระบุแหล่งที่มาของสถานที่นั้นได้จากพร็อพเพอร์ตี้ attributions ใน GMSPlace
ระบบจะระบุ attributions เป็นออบเจ็กต์ NSAttributedString
ดึงข้อมูลการระบุแหล่งที่มาสำหรับคอลเล็กชันสถานที่
หากแอปแสดงข้อมูลที่ได้จากการขอสถานที่ปัจจุบันของอุปกรณ์ แอปต้องแสดงการระบุแหล่งที่มาของบุคคลที่สามสำหรับรายละเอียดสถานที่ที่แสดง คุณสามารถดึงข้อมูลการระบุแหล่งที่มาของสถานที่ทั้งหมดที่ดึงข้อมูลในคำขอได้จากพร็อพเพอร์ตี้ attributions ใน
GMSPlaceLikelihoodList
attributions จะแสดงเป็นออบเจ็กต์ NSAttributedString ซึ่งคุณสามารถเข้าถึงและแสดงในลักษณะเดียวกับ attributions ในสถานที่เดียวตามที่อธิบายไว้ด้านบน
การระบุแหล่งที่มาของผลการค้นหา
ในยุโรป เมื่อใช้การจัดอันดับที่ไม่มีการปรับแต่งของ Google ผลิตภัณฑ์ Search ต้องมีข้อความอธิบายที่เข้าถึงได้ในไม่เกิน 1 คลิก ซึ่งอธิบายปัจจัยหลักและการให้น้ำหนักปัจจัยหลักที่กำหนดการจัดอันดับผลการค้นหา ข้อความอธิบาย:
ส่วนหัว: เกี่ยวกับผลการค้นหาเหล่านี้
เนื้อหา: เมื่อคุณค้นหาธุรกิจหรือสถานที่ที่อยู่ใกล้กับตำแหน่ง Google Maps จะแสดงให้คุณเห็นผลการค้นหาในพื้นที่ ปัจจัยหลายประการ เช่น ความเกี่ยวข้องหลัก ระยะทาง และความโดดเด่น ต่างส่งผลต่อผลลัพธ์ที่ดีที่สุดสำหรับการค้นหาของคุณ
ปุ่ม 1: ดูข้อมูลเพิ่มเติม
ข้อความ "ดูข้อมูลเพิ่มเติม" ควรลิงก์ไปยังบทความในศูนย์ช่วยเหลือ
ปุ่ม 2: ตกลง
แสดงการระบุแหล่งที่มาของรูปภาพ
หากแอปแสดงรูปภาพ คุณต้องแสดง attributions และ authorAttributions สำหรับรูปภาพแต่ละรูปที่มีข้อมูลดังกล่าว
- หากต้องการเข้าถึงการระบุแหล่งที่มา ให้ใช้
GMSPlacePhotoMetadata.attributionsพร็อพเพอร์ตี้นี้เป็นNSAttributedStringหรือnilหากไม่มีการระบุแหล่งที่มาที่จะแสดง - หากต้องการเข้าถึงการระบุแหล่งที่มาของผู้เขียน ให้ใช้
GMSPlacePhotoMetadata.authorAttributionsพร็อพเพอร์ตี้นี้มีอาร์เรย์ของออบเจ็กต์GMSPlaceAuthorAttribution
Swift
GMSPlacesClient.sharedClient().lookUpPhotosForPlaceID(placeID) { (photos, error) -> Void in if let error = error { // TODO: handle the error. print("Error: \(error.description)") } else { // Get attribution for the first photo in the list. if let photo = photos?.results.first { let attributions = photo.attributions } } }
Objective-C
[[GMSPlacesClient sharedClient] lookUpPhotosForPlaceID:placeID callback:^(GMSPlacePhotoMetadataList *_Nullable photos, NSError *_Nullable error) { if (error) { // TODO: handle the error. NSLog(@"Error: %@", [error description]); } else { // Get attribution for the first photo in the list. if (photos.results.count > 0) { GMSPlacePhotoMetadata *photo = photos.results.firstObject; NSAttributedString *attributions = photo.attributions; } } }];
แสดงรีวิว
ออบเจ็กต์ GMSPlace มีรีวิวได้สูงสุด 5 รายการ โดยรีวิวแต่ละรายการจะแสดงด้วยออบเจ็กต์ GMSPlaceReview คุณเลือกแสดงรีวิวเหล่านี้ในแอปได้
เมื่อแสดงรีวิวที่ผู้ใช้ Google เขียน คุณต้องวางชื่อผู้เขียนไว้ใกล้ๆ กัน เมื่อมีข้อมูลในช่องการระบุแหล่งที่มาของผู้เขียนของออบเจ็กต์ GMSPlaceReview เราขอแนะนำให้คุณใส่รูปภาพของผู้เขียนและลิงก์ไปยังโปรไฟล์ของผู้เขียนด้วย รูปภาพต่อไปนี้แสดงตัวอย่าง
รีวิวสวนสาธารณะ

นอกจากนี้ Google ยังแนะนำให้คุณแสดงวิธีจัดเรียงรีวิวต่อผู้ใช้ปลายทางด้วย
วิธีเข้าถึงรีวิว
Swift
// Define a Place ID. let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs" // Specify the place data types to return. let myProperties: [GMSPlaceProperty] = [.name, .website, .reviews] // Create the GMSFetchPlaceRequest object. let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties) client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: { (place: GMSPlace?, error: Error?) in if let error = error { print("An error occurred: \(error.localizedDescription)") return } if let place = place { let firstReview: GMSPlaceReview = place.reviews![0] // Use firstReview to access review text, authorAttribution, and other fields. } })
Objective-C
// Define a Place ID. NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs"; // Specify the place data types to return, including reviews. NSArray<GMSPlaceProperty *> *myProperties = @[GMSPlacePropertyName, GMSPlacePropertyWebsite,GMSPlacePropertyReviews]; GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: myProperties]; [placesClient fetchPlaceWithRequest: fetchPlaceRequest, callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) { if (error) { // TODO: handle the error. NSLog(@"Error: %@", [error description]); } else { // Get first review. GMSPlaceReview *firstReview = [place reviews][0]; // Use firstReview to access review text, authorAttribution, and other fields. } }];
แสดงการระบุแหล่งที่มาของบุคคลที่สาม
การระบุแหล่งที่มาของผู้ให้บริการบุคคลที่สามจะระบุเป็นออบเจ็กต์ NSAttributedString ที่มีเนื้อหาและลิงก์ที่คุณต้องเก็บรักษาและแสดงต่อผู้ใช้
วิธีที่แนะนำในการแสดงการระบุแหล่งที่มาคือการใช้ UITextView เนื่องจากลิงก์ในการระบุแหล่งที่มาต้องใช้งานได้
เพื่อให้ลิงก์ทำงานได้ ให้ตั้งค่าผู้รับมอบสิทธิ์ใน UITextView และตั้งค่าเมธอด shouldInteractWithURL ของ UITextViewDelegate ให้แสดงผลเป็น YES
Swift
... self.attributionTextView.delegate = self ... // MARK: - UITextViewDelegate func textView(textView: UITextView, shouldInteractWithURL URL: NSURL, inRange characterRange: NSRange) -> Bool { // Make links clickable. return true }
Objective-C
... self.attributionTextView.delegate = self; ... #pragma mark - UITextViewDelegate - (BOOL)textView:(UITextView *)textView shouldInteractWithURL:(NSURL *)url inRange:(NSRange)characterRange { // Make links clickable. return YES; }
ตัวอย่างการระบุแหล่งที่มาของบุคคลที่สาม
การระบุแหล่งที่มาของบุคคลที่สามมักประกอบด้วยข้อความที่มีลิงก์ เช่น
ข้อมูลโดย Example Company
ในตัวอย่างด้านบน ช่วงข้อความ Example Company จะครอบคลุมโดยแอตทริบิวต์ NSLink
การเติมข้อความอัตโนมัติสำหรับที่อยู่ของผู้ใช้ปลายทาง
เมื่อผู้ใช้ปลายทางใช้ฟังก์ชันการเติมข้อความอัตโนมัติภายในแอปพลิเคชันของลูกค้าเพื่อพิมพ์ที่อยู่ และผู้ใช้ปลายทางรายนั้นจะระบุที่อยู่ดังกล่าวได้อย่างสมบูรณ์และถูกต้องโดยไม่ต้องใช้การเติมข้อความอัตโนมัติ ที่อยู่ที่ผู้ใช้ปลายทางเลือกจะไม่อยู่ภายใต้ข้อจำกัดด้านเนื้อหาของ Google Maps ในข้อตกลง Google Maps Platform ข้อยกเว้นนี้มีผลเฉพาะกับที่อยู่ซึ่งผู้ใช้ปลายทางเลือกและสำหรับธุรกรรมที่เฉพาะเจาะจงของผู้ใช้ปลายทางรายนั้นเท่านั้น โดยไม่มีผลกับรายการที่อยู่ที่แนะนำซึ่งได้จากฟังก์ชันการเติมข้อความอัตโนมัติหรือเนื้อหาอื่นๆ ของ Google Maps ข้อยกเว้นนี้ไม่มีผลกับฟังก์ชันการค้นหาจุดที่น่าสนใจหรือที่อยู่ซึ่งให้บริการโดยบริการอื่นๆ ของ Google Maps Platform

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