นโยบายและการระบุแหล่งที่มาสำหรับ Places SDK สำหรับ iOS

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

นโยบาย

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

ข้อยกเว้นจากข้อจำกัดในการแคช

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

ประเทศและเขตแดนในเขตเศรษฐกิจยุโรป

ผลิตภัณฑ์นี้มีข้อกำหนดในการให้บริการที่แตกต่างกันสำหรับลูกค้าที่มีที่อยู่สำหรับการเรียกเก็บเงินในเขตเศรษฐกิจยุโรป (EEA) และอาจมีฟังก์ชันการทำงานที่แตกต่างกันด้วย โปรดอ่านข้อกำหนดและข้อมูลต่อไปนี้ที่เฉพาะเจาะจงสำหรับ EEA ก่อนที่จะสร้างแอปด้วย Google Maps Platform

• ข้อกำหนดในการให้บริการของ Google Maps Platform สำหรับ EEA
• ข้อกำหนดเฉพาะบริการของ Google Maps Platform สำหรับ EEA
• คำถามที่พบบ่อย (FAQ) เกี่ยวกับ EEA
• ข้อกำหนดด้านความปลอดภัยบนท้องถนนของ Google Maps Platform

หากที่อยู่สำหรับการเรียกเก็บเงินไม่ได้อยู่ใน EEA ข้อกำหนดในการให้บริการต่อไปนี้จะมีผลกับคุณ

• ข้อกำหนดในการให้บริการของ Google Maps Platform
• ข้อกำหนดเฉพาะบริการของ Google Maps Platform

ข้อกำหนดการระบุแหล่งที่มาของ 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 ให้ทำตามหลักเกณฑ์ต่อไปนี้

• อย่าแก้ไขโลโก้ไม่ว่าในลักษณะใดก็ตาม
• รักษาสัดส่วนภาพของโลโก้เพื่อไม่ให้เกิดการบิดเบี้ยว
• ใช้โลโก้แบบมีเส้นขอบบนพื้นหลังที่ซับซ้อน เช่น แผนที่หรือรูปภาพ
• ใช้โลโก้แบบไม่มีเส้นขอบบนพื้นหลังธรรมดา เช่น สีทึบหรือการไล่ระดับสีแบบละเอียด

ข้อกำหนดขนาดโลโก้

• ความสูงขั้นต่ำของโลโก้: 16dp
• ความสูงสูงสุดของโลโก้: 19dp
• พื้นที่ว่างขั้นต่ำของโลโก้: 10dp ทางซ้าย ขวา และด้านบน 5dp ทางด้านล่าง

ดูข้อมูลเกี่ยวกับ dp ได้ที่ ความหนาแน่นของพิกเซล ในเว็บไซต์ Material Design

การช่วยเหลือพิเศษของโลโก้

• รักษาระดับความแตกต่างที่เข้าถึงได้ระหว่างโลโก้กับพื้นหลัง
• ใส่ป้ายกำกับการช่วยเหลือพิเศษที่มีข้อความ 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" เพื่อเรียกใช้แบบอักษรเริ่มต้นของระบบ
  รูปแบบอักษร	ปกติ
  น้ำหนักแบบอักษร	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 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 ผลิตภัณฑ์การค้นหาต้องมีข้อความอธิบายที่เข้าถึงได้ภายในไม่ เกิน 1 คลิก ซึ่งอธิบายปัจจัยหลักและน้ำหนักของปัจจัยหลักที่ กำหนดการจัดอันดับผลการค้นหา ข้อความอธิบาย

ส่วนหัว: เกี่ยวกับผลการค้นหาเหล่านี้

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

ปุ่ม 1: ดูข้อมูลเพิ่มเติม
"ดูข้อมูลเพิ่มเติม" ข้อความควรลิงก์ไปยังบทความในศูนย์ช่วยเหลือ

ปุ่ม 2: ตกลง

แสดงการระบุแหล่งที่มาสำหรับรูปภาพ

หากแอปแสดง รูปภาพ คุณต้อง แสดง attributions และ authorAttributions สำหรับ รูปภาพแต่ละรูปที่มีการระบุแหล่งที่มา

• หากต้องการเข้าถึงการระบุแหล่งที่มา ให้ใช้ GMSPlacePhotoMetadata.attributions พร็อพเพอร์ตี้นี้เป็น NSAttributedString หรือ nil หาก ไม่มีการระบุแหล่งที่มาที่จะแสดง
• หากต้องการเข้าถึงการระบุแหล่งที่มาของผู้เขียน ให้ใช้ GMSPlacePhotoMetadata.authorAttributions. พร็อพเพอร์ตี้นี้มีอาร์เรย์ของ GMSPlaceAuthorAttribution ออบเจ็กต์

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
    }
  }
}
    

[[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 ยังขอแนะนำให้คุณแสดงวิธีจัดเรียงรีวิวให้ผู้ใช้ปลายทางทราบ

วิธีเข้าถึงรีวิว

// 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.

  }
})

// 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

...
  self.attributionTextView.delegate = self
...

// MARK: - UITextViewDelegate

func textView(textView: UITextView, shouldInteractWithURL URL: NSURL,
  inRange characterRange: NSRange) -> Bool {
  // Make links clickable.
  return true
}
    

...
  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 ข้อยกเว้นนี้ไม่มีผลกับฟังก์ชันการทำงานการค้นหา POI หรือที่อยู่ที่บริการอื่นๆ ของ Google Maps Platform มีให้

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