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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

หากแอปพลิเคชันแสดงข้อมูลใน Google Maps จะมีโลโก้ 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

ทำตามวิธีการเหล่านี้เพื่อเรียกข้อมูลการระบุแหล่งที่มาของบุคคลที่สามสำหรับสถานที่หนึ่งๆ หรือกลุ่มสถานที่

เรียกข้อมูลการระบุแหล่งที่มาของสถานที่แห่งเดียว

เมื่อคุณดึงข้อมูลสถานที่โดยการดึงข้อมูลสถานที่ตามรหัส คุณจะดึงข้อมูลการระบุแหล่งที่มาของสถานที่นั้นได้จากพร็อพเพอร์ตี้ attributions ใน GMSPlace

attributions ระบุเป็นออบเจ็กต์ NSAttributedString

ดึงข้อมูลการระบุแหล่งที่มาของคอลเล็กชันสถานที่

หากแอปแสดงข้อมูลที่ได้จากคําขอตําแหน่งปัจจุบันของอุปกรณ์ แอปต้องแสดงการระบุแหล่งที่มาของบุคคลที่สามสําหรับรายละเอียดสถานที่ที่แสดง คุณสามารถเรียกข้อมูลเครดิตของสถานที่ทั้งหมดที่ดึงข้อมูลในคําขอได้จากพร็อพเพอร์ตี้ attributions ใน GMSPlaceLikelihoodList

attributions ได้รับการระบุเป็นออบเจ็กต์ NSAttributedString ซึ่งเข้าถึงและแสดงในลักษณะเดียวกับ attributions ได้ในที่เดียวตามที่อธิบายไว้ด้านบน

การระบุแหล่งที่มาของผลการค้นหา

ในยุโรป เมื่อใช้การจัดอันดับของ Google แบบไม่เปลี่ยนแปลง ผลิตภัณฑ์การค้นหาต้องมีข้อความอธิบายที่คลิกได้ไม่เกิน 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

ต่อไปนี้คือหลักเกณฑ์ด้านรูปแบบสำหรับการระบุแหล่งที่มาของ Google ใน CSS และ HTML หากคุณไม่สามารถใช้โลโก้ Google ที่ดาวน์โหลดได้

พื้นที่ว่าง

พื้นที่ว่างรอบโลโก้ควรเท่ากับหรือมากกว่าความสูงของ "G" ใน Google

เว้นวรรคระหว่างข้อความระบุแหล่งที่มากับโลโก้ Google ควรมีความกว้างครึ่งหนึ่งของ "G"

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

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

สี

ใช้ข้อความ Google Material Grey 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 ตัวอย่าง

เมื่อใช้กับข้อความ "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;