ข้อมูลอ้างอิงฉบับย่อของ Places SDK สำหรับ iOS

Places SDK สำหรับ iOS ช่วยให้แอป iOS ได้รับข้อมูลเกี่ยวกับสถานที่ (ธุรกิจ จุดที่น่าสนใจ สถานที่ตั้งทางภูมิศาสตร์) ผ่านรายละเอียดสถานที่, รูปภาพสถานที่, การค้นหาข้อความ, การค้นหาในบริเวณใกล้เคียง และการเติมข้อความอัตโนมัติ Places API (ใหม่) เป็น SDK เวอร์ชันปัจจุบัน

Places SDK สำหรับ iOS: ข้อมูลสำคัญ

  • ผลิตภัณฑ์: Places SDK สำหรับ iOS
  • หรือที่เรียกว่า Places SDK สำหรับ iOS (ใหม่)
  • หมวดหมู่: สถานที่
  • แพลตฟอร์ม: iOS
  • ทำงานใน: ไคลเอ็นต์ (โค้ดแอปหรือเบราว์เซอร์)
  • ระยะการเปิดตัว: GA
  • วงจร: ใช้งานอยู่
  • ภาพรวม: ภาพรวมของ Places SDK สำหรับ iOS

Places SDK สำหรับ iOS: กรณีที่ควรใช้

ใช้ Places SDK สำหรับ iOS ในกรณีต่อไปนี้

  • คุณต้องการรายละเอียดสถานที่ รูปภาพ การค้นหาข้อความ หรือผลการค้นหาในบริเวณใกล้เคียงภายในแอป iOS แบบเนทีฟ
  • คุณต้องการการเติมชื่อสถานที่หรือที่อยู่อัตโนมัติขณะที่ผู้ใช้พิมพ์ในแอป iOS
  • คุณต้องการคอมโพเนนต์ Places UI Kit ที่สร้างไว้ล่วงหน้า (รายละเอียดสถานที่, การค้นหา, การเติมข้อความอัตโนมัติ) ในแอป iOS

อย่าใช้ Places SDK สำหรับ iOS ในกรณีต่อไปนี้

  • คุณกำลังสร้างแอป Android แบบเนทีฟ โปรดใช้ Places SDK สำหรับ Android แทน
  • คุณกำลังสร้างหน้าเว็บในเบราว์เซอร์ โปรดใช้ Maps JavaScript API แทน
  • คุณต้องการข้อมูลสถานที่จากเซิร์ฟเวอร์หรือแบ็กเอนด์ผ่าน HTTP แทนที่จะเป็นในไคลเอ็นต์ iOS โปรดใช้ Places API (ใหม่) แทน

Places SDK สำหรับ iOS: การตั้งค่า

แพ็กเกจ Places SDK สำหรับ iOS อย่างเป็นทางการ

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

Places SDK สำหรับ iOS: ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: การเรียก Places SDK สำหรับ iOS (ใหม่) จะไม่สำเร็จหากไม่ได้เปิดใช้ Places API (ใหม่) ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ หรือไม่ได้อยู่ในรายการ API ที่ได้รับอนุญาตของคีย์ API วิธีแก้ไข: เปิดใช้ Places API (ใหม่) และเพิ่มลงในข้อจำกัดของคีย์ API ที่แอปใช้ ดู /maps/documentation/places/ios-sdk/legacy/migrate-overview
  • ปัญหา: kGMSPlacesRateLimitExceeded (-7) หมายความว่าคีย์ API มีการใช้งานเกินการจำกัดอัตราคำขอ แอปใน SDK เวอร์ชัน 2.x ที่ปิดอยู่ (ปิดเมื่อวันที่ 29 กรกฎาคม 2019) ก็ได้รับข้อผิดพลาดนี้เช่นกัน วิธีแก้ไข: ตรวจสอบโควต้าและการใช้งาน Places API (ใหม่) ในคอนโซล Google Cloud และอัปเดตแอปใน SDK เวอร์ชันก่อน 3.0 ดู /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode
  • ปัญหา: โทเค็นของเซสชันที่ใช้ซ้ำในแอปต่างๆ ในโปรเจ็กต์เดียวกันหรือในเซสชันต่างๆ จะทำให้การจัดกลุ่มการเรียกเก็บเงินของเซสชันการเติมข้อความอัตโนมัติใช้งานไม่ได้ วิธีแก้ไข: สร้างโทเค็นของเซสชันที่ไม่ซ้ำกัน (แนะนำให้ใช้ UUID เวอร์ชัน 4) ต่อเซสชันการเติมข้อความอัตโนมัติ โดยโทเค็นต้องไม่ซ้ำกันในแต่ละโปรเจ็กต์ ดู /maps/documentation/places/ios-sdk/use-session-tokens
  • ปัญหา: แอปแสดงข้อมูลสถานที่โดยไม่มีการระบุแหล่งที่มาที่ API แสดงผล วิธีแก้ไข: แสดงการระบุแหล่งที่มาที่เกี่ยวข้องทั้งหมดที่แสดงผลพร้อมกับข้อมูล Places ตามหน้านโยบาย ดู /maps/documentation/places/ios-sdk/overview

Places SDK สำหรับ iOS: ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว

  • Places SDK สำหรับ iOS (เวอร์ชันเดิม): เวอร์ชันเดิมตั้งแต่วันที่ 1 มีนาคม 2025 รายการทดแทน: Places SDK สำหรับ iOS (ใหม่) (ต้องใช้ Places API (ใหม่)) อาการ: คลาสและเมธอดเดิม (เช่น fetchPlaceFromPlaceID, GMSAutocompleteFetcher และ GMSAutocompleteViewController) ไม่มีอยู่ใน SDK 11.0.0 ขึ้นไป ซึ่งทำให้การคอมไพล์ไม่สำเร็จ ดูคำแนะนำในการย้ายข้อมูล
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner และ GMSAutocompleteFetcher initWithBounds:filter: เลิกใช้งานตั้งแต่วันที่ 13-10-2020 การแทนที่: GMSAutocompleteFilter (locationBias หรือ locationRestriction) ใน GMSAutocompleteRequest ด้วย GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: หรือตัวแก้ไข GooglePlacesSwift placeAutocomplete หรือ basicPlaceAutocomplete สำหรับวิดเจ็ต UI อาการ: เมธอดไม่มีอยู่ใน SDK 4.0.0 ขึ้นไป (และ GMSAutocompleteResultsViewController และ GMSAutocompleteFetcher ถูกนำออกใน SDK 11.0.0) ดูคำแนะนำในการย้ายข้อมูล
  • ขอบเขตการเติมข้อความอัตโนมัติตามGMSCoordinateBounds (พารามิเตอร์ GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode; bounds/boundsMode ของ findAutocompletePredictionsFromQuery และ autocompleteQuery): เลิกใช้งานตั้งแต่วันที่ 13-10-2020 การแทนที่: GMSAutocompleteRequest ด้วย GMSAutocompleteFilter (locationBias หรือ locationRestriction) และ GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: หรือตัวแก้ไข GooglePlacesSwift placeAutocomplete หรือ basicPlaceAutocomplete สำหรับวิดเจ็ต UI อาการ: พร็อพเพอร์ตี้และพารามิเตอร์ไม่มีอยู่ใน SDK 4.0.0 ขึ้นไป (และ GMSAutocompleteViewController และ findAutocompletePredictionsFromQuery ถูกนำออกใน SDK 11.0.0) ดูคำแนะนำในการย้ายข้อมูล
  • GMSPlace.openNowStatus: เลิกใช้งานตั้งแต่วันที่ 13-10-2020 การเปลี่ยนทดแทน: GMSPlacesClient isOpenWithRequest:callback: (GMSPlaceIsOpenRequest) หรือ PlacesClient.isPlaceOpen(with:) ใน GooglePlacesSwift อาการ: พร็อพเพอร์ตี้ไม่มีอยู่ใน SDK 4.0.0 ขึ้นไป ดูคำแนะนำในการย้ายข้อมูล
  • GMSPlaceField เป็น NS_ENUM: เลิกใช้งานตั้งแต่วันที่ 13-10-2020 การแทนที่: GMSPlaceProperty ค่าคงที่ที่มีคลาสคำขอ เช่น GMSFetchPlaceRequest และ GMSPlaceSearchByTextRequest หรือ PlaceProperty ใน GooglePlacesSwift อาการ: แทนที่ด้วย NS_OPTIONS ใน SDK 4.0.0 (GMSPlaceField เนื่องจาก NS_OPTIONS เป็นของ API เดิมและไม่มีใน SDK 11.0.0 ขึ้นไป) ดูคำแนะนำในการย้ายข้อมูล
  • Places SDK สำหรับ iOS เวอร์ชัน 2.7.0: เลิกใช้งานตั้งแต่วันที่ 29 กรกฎาคม 2019 รายการทดแทน: Places SDK สำหรับ iOS เวอร์ชันปัจจุบัน อาการ: ข้อผิดพลาด kGMSPlacesRateLimitExceeded

สิ่งที่คุณทำได้ด้วย Places SDK สำหรับ iOS

ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ

Places SDK สำหรับ iOS: Generative AI

Places SDK สำหรับ iOS: Places

Places SDK สำหรับ iOS: Places UI Kit

  • ใช้การจัดรูปแบบ CSS กับองค์ประกอบ UI ของข้อมูลสถานที่ หมายเหตุ: พร็อพเพอร์ตี้ที่กำหนดเองของ CSS จะใช้กับองค์ประกอบ Places UI Kit ของ Maps JavaScript API ส่วน Places SDK สำหรับ Android และ Places SDK สำหรับ iOS จะจัดรูปแบบมุมมอง Places UI Kit แบบเป็นโปรแกรมโดยใช้แอตทริบิวต์ธีมและสไตล์ ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
  • ปรับแต่งการจัดรูปแบบและการกำหนดค่าองค์ประกอบ UI ของข้อมูลสถานที่ด้วยเครื่องมือปรับแต่งองค์ประกอบ UI หมายเหตุ: ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
  • เพิ่มองค์ประกอบ UI ที่แสดงข้อมูลเกี่ยวกับสถานที่หนึ่งๆ ลงในหน้าเว็บหรือแอปบนอุปกรณ์เคลื่อนที่ หมายเหตุ: ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: หากต้องการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
  • เพิ่มองค์ประกอบ UI ที่แสดงรายการสถานที่ตามสตริงการค้นหาลงในหน้าเว็บ หมายเหตุ: รองรับทั้งในหน้าเว็บ (Maps JavaScript API) และแอปบนอุปกรณ์เคลื่อนที่ (Places SDK สำหรับ Android และ Places SDK สำหรับ iOS) ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
  • เพิ่มองค์ประกอบ UI ที่แสดงรายการสถานที่ใกล้กับตำแหน่งที่เฉพาะเจาะจงลงในหน้าเว็บ หมายเหตุ: รองรับทั้งในหน้าเว็บ (Maps JavaScript API) และแอปบนอุปกรณ์เคลื่อนที่ (Places SDK สำหรับ Android และ Places SDK สำหรับ iOS) ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
  • เพิ่มองค์ประกอบ UI การเติมข้อความอัตโนมัติพื้นฐานลงในหน้าเว็บหรือแอปที่แสดงตัวระบุ Google Place ตามสตริงการค้นหา หมายเหตุ: ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq