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

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

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

การระบุแหล่งที่มาที่ส่งไปยังผู้ให้บริการบุคคลที่สามประกอบด้วยเนื้อหาและลิงก์ที่คุณ ต้องแสดงต่อผู้ใช้ในรูปแบบที่ระบุไว้ 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"

ความอ่านง่าย

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

สี

ใช้ข้อความ 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;