เอกสารนี้ระบุข้อกำหนดเฉพาะสำหรับแอปพลิเคชันทั้งหมด ที่พัฒนาโดย Places SDK สำหรับ iOS ซึ่งรวมถึงการเติมข้อมูลอัตโนมัติเกี่ยวกับสถานที่ บริการที่เป็นส่วนหนึ่งของ API นั้น ข้อมูลทั่วไปเพิ่มเติมสำหรับ Google Maps นักพัฒนาซอฟต์แวร์อาจพบได้ใน ข้อกำหนดในการให้บริการของ Google Maps Platform
ให้ข้อกำหนดในการใช้งานและนโยบายความเป็นส่วนตัว
ถ้าคุณพัฒนาแอปพลิเคชัน Places SDK สำหรับ iOS คุณต้องทำให้ ข้อกำหนด ในการใช้งาน และ ความเป็นส่วนตัว นโยบายเกี่ยวกับแอปพลิเคชันของคุณ ซึ่งเป็นไปตามหลักเกณฑ์ที่ระบุไว้ในข้อตกลงระหว่างคุณกับ Google
- ข้อกำหนดในการใช้งานและนโยบายความเป็นส่วนตัวต้องเป็นข้อมูลสาธารณะ พร้อมใช้งาน
- คุณต้องระบุไว้ในข้อกำหนดในการให้บริการของแอปพลิเคชันของคุณอย่างชัดแจ้งว่า เมื่อใช้แอปพลิเคชันของคุณ ผู้ใช้ ข้อกำหนดในการให้บริการของ Google บริการ
- คุณต้องแจ้งให้ผู้ใช้ทราบในนโยบายความเป็นส่วนตัวที่คุณกำลังใช้ Google แผนที่ API และรวมไว้โดยการอ้างอิง นโยบายความเป็นส่วนตัวของ Google
ที่ที่แนะนำให้เปิดเผยข้อกำหนดในการใช้งาน และ นโยบายความเป็นส่วนตัวขึ้นอยู่กับแพลตฟอร์มของแอปพลิเคชัน
แอปพลิเคชันบนอุปกรณ์เคลื่อนที่
หากคุณต้องการพัฒนาแอปบนอุปกรณ์เคลื่อนที่ ขอแนะนำให้คุณระบุลิงก์ไปยัง ข้อกำหนดในการให้บริการและนโยบายความเป็นส่วนตัวใน หน้าดาวน์โหลดใน App Store ที่เกี่ยวข้อง และในการตั้งค่าแอปพลิเคชัน เมนู
เว็บแอปพลิเคชัน
หากคุณต้องการพัฒนาเว็บแอปพลิเคชัน ขอแนะนำให้คุณระบุลิงก์ไปยัง ข้อกำหนดในการให้บริการและนโยบายความเป็นส่วนตัวในส่วนท้ายของ เว็บไซต์ของคุณ
การดึงข้อมูลล่วงหน้า การแคช หรือการจัดเก็บเนื้อหา
แอปพลิเคชันที่ใช้ Places SDK สำหรับ iOS ต้องเป็นไปตามข้อกำหนดของ ข้อตกลงกับ Google ตามข้อกำหนดในข้อตกลง คุณต้องไม่ ดึงข้อมูลล่วงหน้า จัดทำดัชนี จัดเก็บ หรือแคชเนื้อหาใดๆ ยกเว้นภายใต้ข้อจำกัด เงื่อนไขที่ระบุไว้ในข้อกำหนด
โปรดทราบว่ารหัสสถานที่ที่ใช้ระบุสถานที่โดยไม่ซ้ำกัน ได้รับการยกเว้นจากข้อจำกัดการแคช ระบบจะแสดงรหัสสถานที่ในช่อง "รหัสสถานที่" ใน Places SDK สำหรับการตอบกลับของ iOS ดูวิธีบันทึก รีเฟรช และจัดการรหัสสถานที่ได้ในคำแนะนำเกี่ยวกับรหัสสถานที่
การแสดง Places SDK สำหรับผลลัพธ์ของ iOS
คุณสามารถแสดง Places SDK สำหรับผลลัพธ์ของ iOS บน Google Maps หรือโดยไม่มีแผนที่ได้ หากคุณต้องการ แสดงผลลัพธ์ของ Places SDK สำหรับ iOS บนแผนที่ ผลลัพธ์เหล่านี้จะต้องแสดงบน Google Maps ห้ามใช้ Places SDK สำหรับข้อมูล iOS บนแผนที่ที่ไม่ใช่แผนที่ของ Google
การแสดงโลโก้ของ Google และการระบุแหล่งที่มา
หากแอปพลิเคชันของคุณแสดงข้อมูลบน Google แผนที่ บัญชี Google โลโก้จะอยู่ในภาพและไม่สามารถดัดแปลงแก้ไขได้ แอปพลิเคชันที่แสดงข้อมูลของ Google บนหน้าจอเดียวกับ Google Maps ไม่จำเป็นต่อการระบุแหล่งที่มาเพิ่มเติมให้กับ Google
หากแอปพลิเคชันของคุณแสดงข้อมูลบนหน้าเว็บหรือมุมมองที่ไม่ แสดง Google Maps ด้วย คุณต้องแสดงโลโก้ Google พร้อมกับข้อมูลนั้น ตัวอย่างเช่น ถ้าแอปพลิเคชันของคุณแสดงข้อมูลของ Google บนแท็บหนึ่ง และ Google Maps ที่มีข้อมูลนั้น บนแท็บอื่น แท็บแรกต้องแสดงโลโก้ Google หากแอปพลิเคชันใช้ ช่องค้นหาที่มีหรือไม่มีการเติมข้อความอัตโนมัติ โลโก้ต้องแสดงในบรรทัด
โลโก้ Google ควรวางอยู่ที่มุมล่างซ้ายของแผนที่โดยแสดงที่มา ที่วางไว้ที่มุมขวาล่าง ซึ่งข้อมูลทั้ง 2 อย่างนี้ควรอยู่บนแผนที่ ซึ่งแสดงโดยรวมและไม่ได้อยู่ใต้แผนที่หรือสถานที่อื่นภายในแอปพลิเคชัน ตัวอย่างแผนที่ต่อไปนี้แสดงโลโก้ Google ที่ด้านซ้ายล่างของแผนที่ และการระบุแหล่งที่มา ที่ด้านล่างขวา
![ตำแหน่งการระบุแหล่งที่มาของนโยบาย](https://developers.google.com/static/maps/images/policies_attribution_placement.png?hl=th)
สำหรับใช้กับพื้นหลังสีอ่อน | สำหรับใช้กับพื้นหลังสีเข้ม |
---|---|
![]() |
![]() |
ไฟล์ ZIP ต่อไปนี้มีโลโก้ Google ในขนาดที่ถูกต้องสำหรับ เดสก์ท็อป, Android และ iOS คุณไม่สามารถปรับขนาดหรือแก้ไข โลโก้ในลักษณะใดลักษณะหนึ่ง
ดาวน์โหลด: google_logo.zip
อย่าแก้ไขการระบุแหล่งที่มา อย่านำออก ปิดบัง หรือครอบตัดการแสดงที่มา คุณไม่สามารถใช้โลโก้ Google ในบรรทัด (ตัวอย่างเช่น "แผนที่เหล่านี้ จาก [Google_logo]")
รักษาการระบุแหล่งที่มาไว้ใกล้เคียง หากใช้ภาพหน้าจอของ Google ภาพนอก เป็นการฝังโดยตรง จะมีการระบุแหล่งที่มามาตรฐานตามที่ปรากฏในรูปภาพ หากจำเป็น คุณสามารถปรับแต่งรูปแบบและตำแหน่งของข้อความแสดงที่มา ตราบใดที่ข้อความดังกล่าว ที่อยู่ใกล้กับเนื้อหา และสามารถอ่านได้ง่ายสำหรับผู้ชมหรือผู้อ่านทั่วไป คุณไม่สามารถย้ายการระบุแหล่งที่มาออกจากเนื้อหา เช่น ท้ายหนังสือ เครดิตของไฟล์หรือรายการ หรือส่วนท้ายของเว็บไซต์
รวมผู้ให้บริการข้อมูลบุคคลที่สาม ข้อมูลและรูปภาพบางส่วนในการทำแผนที่ของเรา ผลิตภัณฑ์มาจากผู้ให้บริการรายอื่นที่ไม่ใช่ Google หากใช้ภาพดังกล่าว ข้อความจาก การระบุแหล่งที่มาต้องระบุชื่อ "Google" และผู้ให้บริการข้อมูลที่เกี่ยวข้อง เช่น "ข้อมูลแผนที่: Google, Maxar Technologies" เมื่อมีการอ้างอิงผู้ให้บริการข้อมูลบุคคลที่สาม ที่มีภาพ รวมถึงเฉพาะคำว่า "Google" หรือโลโก้ Google แสดงที่มาไม่ถูกต้อง
หากคุณใช้ Google Maps Platform ในอุปกรณ์ที่ไม่แสดงการระบุแหล่งที่มา หากเป็นไปได้ โปรดติดต่อทีมขายของ Google เพื่อพูดคุยเกี่ยวกับใบอนุญาตที่เหมาะสมกับกรณีการใช้งานของคุณ
ข้อกำหนดในการระบุแหล่งที่มาอื่นๆ
การระบุแหล่งที่มาที่ส่งไปยังผู้ให้บริการบุคคลที่สามประกอบด้วยเนื้อหาและลิงก์ที่คุณ ต้องแสดงต่อผู้ใช้ในรูปแบบที่ระบุไว้ Google แนะนำให้แอปของคุณแสดงข้อมูลนี้ใต้รายละเอียดสถานที่
การระบุแหล่งที่มาของบุคคลที่สามแสดงผลโดย API จะไม่รวมการระบุแหล่งที่มาของ Google ไว้ด้วย คุณต้อง ให้รวมการระบุแหล่งที่มานี้ด้วยตัวเอง ตามที่อธิบายไว้ใน การแสดงโลโก้ของ Google และการระบุแหล่งที่มา
ทําตามวิธีการเหล่านี้เพื่อดึงข้อมูลการระบุแหล่งที่มาของบุคคลที่สามสําหรับ สถานที่หรือคอลเล็กชันของสถานที่
ดึงข้อมูลแหล่งที่มาของสถานที่แห่งเดียว
เมื่อคุณเรียกข้อมูลสถานที่โดยการรับ
Place ด้วย ID คุณ
สามารถดึงข้อมูลการระบุแหล่งที่มาของสถานที่นั้นจาก
พร็อพเพอร์ตี้ attributions
เปิดอยู่
GMSPlace
attributions
ได้รับการจัดหาให้เป็น
NSAttributedString
ออบเจ็กต์
ดึงข้อมูลการระบุแหล่งที่มาของคอลเล็กชันสถานที่
หากแอปแสดงข้อมูลที่ได้จากคำขอข้อมูลต่อไปนี้
สถานที่ปัจจุบัน แอปจะต้องแสดง
การระบุแหล่งที่มาของบุคคลที่สามสำหรับรายละเอียดสถานที่ที่แสดง คุณสามารถเรียกข้อมูล
การระบุแหล่งที่มาของทุกตำแหน่งที่ถูกเรียกในคำขอ จาก
พร็อพเพอร์ตี้ attributions
เปิดอยู่
GMSPlaceLikelihoodList
attributions
ได้รับการจัดหาให้เป็น
NSAttributedString
ซึ่งคุณเข้าถึงและแสดงได้ใน
เหมือนกับ attributions
ในตำแหน่งเดียว ตามที่อธิบายไว้
ด้านบน
แสดงที่มาของรูปภาพ
หากแอปแสดง
รูปภาพ คุณต้อง
แสดง 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; }
ตัวอย่างการระบุแหล่งที่มาของบุคคลที่สาม
การระบุแหล่งที่มาของบุคคลที่สามมักประกอบด้วยข้อความที่มีลิงก์ สำหรับ ตัวอย่าง:
ข้อมูลโดยบริษัทตัวอย่าง
ในตัวอย่างข้างต้น ช่วงข้อความของบริษัทตัวอย่างครอบคลุมโดย
NSLink
หลักเกณฑ์ด้านรูปแบบสำหรับการระบุแหล่งที่มาของ Google
ต่อไปนี้คือหลักเกณฑ์ด้านรูปแบบสำหรับการระบุแหล่งที่มาของ Google ใน CSS และ HTML หากคุณใช้ โลโก้ Google ที่ดาวน์โหลดได้
พื้นที่ว่าง
พื้นที่ว่างรอบๆ โลโก้ตัวเต็มควรเท่ากับหรือมากกว่าความสูง ของ "G" ใน Google
ช่องว่างระหว่างข้อความระบุแหล่งที่มาและโลโก้ Google ควรมีความกว้างเพียงครึ่งหนึ่งของ "G"
![](https://developers.google.com/static/maps/images/policies_spacing.png?hl=th)
ความอ่านง่าย
ชื่อผู้เขียนควรชัดเจน อ่านออกได้ง่าย และมีรูปแบบสีที่ถูกต้องสำหรับ ความเป็นมา ดูให้แน่ใจว่ามีความแตกต่างมากพอสำหรับ รูปแบบโลโก้ที่คุณ เลือก
สี
ใช้ข้อความ 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;