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

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

นโยบาย

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

การจัดเก็บข้อมูล การแคช และการสแครปข้อมูล

เมื่อใช้เนื้อหา Google Maps ในแอปพลิเคชัน ให้ปฏิบัติตามข้อกำหนดในการจัดการข้อมูลในส่วนที่ 3.2.3 ของข้อกำหนดในการให้บริการของ Google Maps Platform และข้อกำหนดที่เฉพาะเจาะจงของบริการ Google Maps Platform ดังนี้

  • ข้อจำกัดในการแคชและการสแครป (ส่วนที่ 3.2.3(ก) และ (ข)): แคชหรือจัดเก็บเนื้อหา Google Maps ตามที่ได้รับอนุญาตอย่างชัดแจ้งภายใต้ข้อกำหนดเฉพาะของบริการ Google Maps Platform เท่านั้น ห้ามส่งออก ดึงข้อมูล หรือคัดลอกเนื้อหา Google Maps เพื่อใช้นอกบริการ ตัวอย่างเช่น ห้ามดึงข้อมูลล่วงหน้า จัดทำดัชนี จัดเก็บ หรือแจกจ่ายเนื้อหา Google Maps นอกบริการซ้ำ ดาวน์โหลดชิ้นส่วนแผนที่ ภาพ Street View, รหัสพิกัดภูมิศาสตร์, เส้นทาง, ผลลัพธ์เมทริกซ์ระยะทาง, ข้อมูลถนน, ข้อมูลสถานที่, ค่าระดับความสูง หรือรายละเอียดเขตเวลาเป็นจำนวนมาก หรือคัดลอกและบันทึกชื่อธุรกิจ ที่อยู่ หรือรีวิวจากผู้ใช้
  • ข้อจำกัดด้านเนื้อหาที่ได้มา (ส่วนที่ 3.2.3(ค)): ใช้เนื้อหา Google Maps ภายในแอปพลิเคชันของคุณตามที่ข้อกำหนดในการให้บริการของ Google Maps Platform อนุญาต อย่าสร้างเนื้อหาโดยอิงตามเนื้อหาของ Google Maps ตัวอย่างเช่น ห้ามติดตามหรือแปลงฟีเจอร์จากภาพถ่ายจากดาวเทียมเป็นดิจิทัล สร้างโมเดล 3 มิติหรือโมเดลภูมิประเทศ ใช้ค่าละติจูดและลองจิจูดของ Places เป็นอินพุตสำหรับการวิเคราะห์จุดในรูปหลายเหลี่ยม สร้างดัชนีตำแหน่งจากภาพ Street View หรือแปลงเวลาขับรถแบบข้อความเป็นเสียงสังเคราะห์

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

วิศวกรฝ่ายสนับสนุนด้านเทคนิคของ Google ไม่สามารถให้คำแนะนำทางกฎหมายหรือให้ข้อยกเว้นสำหรับข้อกำหนดในการให้บริการของ Google Maps Platform ได้ โปรดปรึกษาที่ปรึกษาด้านกฎหมายเพื่อพิจารณาว่าการใช้งานของคุณเป็นไปตามข้อกำหนดหรือไม่ หรือติดต่อฝ่ายขายหากกรณีการใช้งานของคุณต้องมีการอนุญาตให้ใช้สิทธิที่กำหนดเอง

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

ข้อกำหนดเฉพาะของบริการ Google Maps Platform ให้ข้อยกเว้นการแคชแบบจำกัดต่อไปนี้

  • รหัสสถานที่: รหัสสถานที่ที่ใช้ระบุสถานที่โดยไม่ซ้ำกันจะได้รับการยกเว้นจากข้อจำกัดในการแคช ดังนั้นคุณจึงจัดเก็บค่ารหัสสถานที่ได้โดยไม่มีกำหนด ระบบจะแสดงรหัสสถานที่ในช่อง id หรือ place_id ในการตอบกลับจาก API ดูวิธีบันทึก รีเฟรช และจัดการรหัสสถานที่ได้ในคู่มือรหัสสถานที่
  • พิกัดละติจูดและลองจิจูด: คุณสามารถแคชค่าละติจูด (latitude) และลองจิจูด (longitude) ไว้ชั่วคราวได้สูงสุด 30 วันตามปฏิทินติดต่อกัน หลังจากนั้นคุณต้องลบพิกัดที่แคชไว้เมื่อใช้บริการที่ให้ข้อยกเว้นนี้ในข้อกำหนดเฉพาะของบริการ Google Maps Platform ดังนี้
    • Routes API, Route Optimization API, Directions API (เดิม) และ Roads API
    • Geocoding API, Geolocation API และ Address Validation API
    • Places API, Places UI Kit และ Navigation SDK
  • ระยะเวลาการแคชเฉพาะบริการ: ข้อกำหนดเฉพาะบริการของ Google Maps Platform ยังกำหนดระยะเวลาการแคชเฉพาะช่องและวัตถุประสงค์ที่อนุญาตสำหรับ Address Validation API, Air Quality API, Pollen API, Solar API, Weather API และ Places Aggregate API ด้วย

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

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

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

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

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

ตัวอย่างการระบุแหล่งที่มา

ต่อไปนี้คือตัวอย่างการระบุแหล่งที่มาสำหรับ Places UI Kit

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

แสดงการระบุแหล่งที่มาของ 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

ดาวน์โหลดโลโก้ Google Maps

ใช้ไฟล์โลโก้ Google Maps อย่างเป็นทางการ ดาวน์โหลดโลโก้ด้านล่างและปฏิบัติตามหลักเกณฑ์ในส่วนนี้

ดาวน์โหลดชิ้นงานการระบุแหล่งที่มาของ Google Maps

โปรดปฏิบัติตามหลักเกณฑ์ต่อไปนี้เมื่อใช้โลโก้ Google Maps

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

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

โปรดปฏิบัติตามข้อกำหนดด้านขนาดต่อไปนี้สำหรับโลโก้ Google Maps
  • ความสูงขั้นต่ำของโลโก้: 16dp
  • ความสูงสูงสุดของโลโก้: 19dp
  • ระยะห่างขั้นต่ำที่ชัดเจนของโลโก้: 10 dp ทางด้านซ้าย ขวา และด้านบน และ 5 dp ที่ด้านล่าง

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

โลโก้ Google Maps ที่แสดงพื้นที่ว่างขั้นต่ำและช่วงขนาดที่ยอมรับได้
ตัวอย่างโลโก้ Google Maps ที่แสดงพื้นที่ว่างขั้นต่ำและช่วงขนาดที่ยอมรับได้

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

ปฏิบัติตามข้อกำหนดด้านการช่วยเหลือพิเศษต่อไปนี้สำหรับโลโก้ Google Maps
รูปแบบที่ไม่ยอมรับและปัญหาด้านการช่วยเหลือพิเศษสำหรับการระบุแหล่งที่มาด้วยโลโก้ Google Maps
ตัวอย่างรูปแบบที่ยอมรับไม่ได้และปัญหาด้านการช่วยเหลือพิเศษสำหรับการระบุแหล่งที่มาด้วยโลโก้ Google Maps

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

หากขนาดของอินเทอร์เฟซไม่รองรับการใช้โลโก้ 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
  • จัดรูปแบบข้อความ 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 Maps ที่ด้านบน ด้านล่าง และด้านข้างของเนื้อหา
ตัวอย่างการระบุแหล่งที่มาของ Google Maps ที่ด้านบน ด้านล่าง และด้านข้างของเนื้อหา

ตัวอย่าง 2 วิธีในการแยกความแตกต่างระหว่างเนื้อหา Google Maps (คะแนนของสถานที่) กับเนื้อหาอื่นๆ
ตัวอย่าง 2 วิธีในการแยกความแตกต่างระหว่างเนื้อหา Google Maps (คะแนนของสถานที่) กับเนื้อหาอื่นๆ

อย่าบดบังการระบุแหล่งที่มาของ Google Maps หรือผสมกับเนื้อหาจากแหล่งที่มาอื่นๆ
อย่าบดบังการระบุแหล่งที่มาของ Google Maps หรือผสมกับเนื้อหาจากแหล่งที่มาอื่นๆ

ผู้ให้บริการข้อมูลบุคคลที่สาม

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