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.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API
- การระบุแหล่งที่มาของการใช้งาน: เรียกใช้เมธอดคลาส
addInternalUsageAttributionIDในGMSPlacesClient(Objective-C/Swift) หรือPlacesClient(GooglePlacesSwift) เพื่อเพิ่มรหัสการระบุแหล่งที่มาของการใช้งาน การลบการเรียกใช้จะเป็นการเลือกไม่ใช้ - เริ่มต้นใช้งาน: ตั้งค่า Places SDK สำหรับ iOS
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิง Places SDK สำหรับ iOS
- ราคา: การใช้งานและการเรียกเก็บเงินของ Places SDK สำหรับ iOS
- นโยบาย: นโยบาย Places SDK สำหรับ iOS
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Places SDK สำหรับ iOS
แพ็กเกจ Places SDK สำหรับ iOS อย่างเป็นทางการ
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
Places SDK สำหรับ iOS: ผลิตภัณฑ์ที่เกี่ยวข้อง
- มักใช้ร่วมกับ: Maps SDK สำหรับ iOS
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 ขึ้นไป ซึ่งทำให้การคอมไพล์ไม่สำเร็จ ดูคำแนะนำในการย้ายข้อมูล GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCornerและGMSAutocompleteFetcherinitWithBounds:filter: เลิกใช้งานตั้งแต่วันที่ 13-10-2020 การแทนที่:GMSAutocompleteFilter(locationBiasหรือlocationRestriction) ในGMSAutocompleteRequestด้วยGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:หรือตัวแก้ไขGooglePlacesSwiftplaceAutocompleteหรือ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) และGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:หรือตัวแก้ไขGooglePlacesSwiftplaceAutocompleteหรือbasicPlaceAutocompleteสำหรับวิดเจ็ต UI อาการ: พร็อพเพอร์ตี้และพารามิเตอร์ไม่มีอยู่ใน SDK 4.0.0 ขึ้นไป (และGMSAutocompleteViewControllerและfindAutocompletePredictionsFromQueryถูกนำออกใน SDK 11.0.0) ดูคำแนะนำในการย้ายข้อมูล GMSPlace.openNowStatus: เลิกใช้งานตั้งแต่วันที่ 13-10-2020 การเปลี่ยนทดแทน:GMSPlacesClientisOpenWithRequest: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
- แสดงข้อมูลสรุปที่ทำงานด้วยระบบ AI ของรีวิวจากผู้ใช้สำหรับตัวระบุ Google Place ที่ระบุ
- แสดงข้อมูลสรุปเกี่ยวกับสถานที่ซึ่งทำงานด้วยระบบ AI ของพื้นที่และสิ่งอำนวยความสะดวกรอบๆ ตัวระบุ Google Places ที่ระบุสำหรับสถานีชาร์จรถยนต์ไฟฟ้า
Places SDK สำหรับ iOS: Places
- แสดงผลรายการสถานที่และรายละเอียดสถานที่ตามสตริงการค้นหา
- แสดงรายการสถานที่และรายละเอียดสถานที่ใกล้กับสถานที่หนึ่งๆ
- แสดงผลการเติมข้อความอัตโนมัติเกี่ยวกับสถานที่ตามสตริงการค้นหา
- แสดงข้อมูลโดยละเอียดเกี่ยวกับสถานที่ที่เจาะจง
- แสดงรูปภาพของสถานที่ที่เจาะจง หมายเหตุ: แสดงการระบุแหล่งที่มาของผู้เขียนรูปภาพแต่ละรูป (ชื่อของผู้เขียนที่ลิงก์กับ URI โปรไฟล์) พร้อมกับรูปภาพ นโยบาย Places สำหรับแต่ละแพลตฟอร์มกำหนดให้ต้องระบุข้อมูลนี้ เช่น /maps/documentation/javascript/policies#photo-attributions และ /maps/documentation/places/web-service/policies#photos-and-review
- ปรับขนาดรูปภาพของสถานที่
- แสดงคะแนนและรีวิวของสถานที่ที่เฉพาะเจาะจง หมายเหตุ: ในเว็บเซอร์วิส Places API (ใหม่) รายละเอียดสถานที่เป็นคำขอ HTTP GET ไปยัง https://places.googleapis.com/v1/places/{placeId} ที่มี X-Goog-FieldMask (เช่น rating,userRatingCount,reviews) ส่วนการค้นหาข้อความ การค้นหาในบริเวณใกล้เคียง และการเติมข้อความอัตโนมัติจะใช้ POST ใน Android ให้ส่ง Place.Field.RATING, USER_RATING_COUNT และ REVIEWS ไปยัง PlacesClient.fetchPlace() ใน iOS ให้ส่ง GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal และ GMSPlacePropertyReviews ใน GMSFetchPlaceRequest
- เพิ่มวิดเจ็ตการเติมข้อความอัตโนมัติลงในหน้าเว็บหรือแอปที่แสดงผลลัพธ์เกี่ยวกับสถานที่ตามสตริงการค้นหา
- ระบุฟิลด์ข้อมูลที่รวมอยู่ในการตอบกลับข้อมูลสถานที่
- ระบุประเภทสถานที่ที่จะรวมไว้ในการตอบกลับข้อมูลสถานที่
- แสดงข้อมูลเกี่ยวกับสถานที่ที่อุปกรณ์ของผู้ใช้อยู่ในปัจจุบัน หมายเหตุ: ระบบได้นำเมธอด Current Place เดิมออกใน Places SDK สำหรับ Android เวอร์ชัน 6.0 ขึ้นไปและ Places SDK สำหรับ iOS เวอร์ชัน 11.0 ขึ้นไป โปรดดึงข้อมูลพิกัดของอุปกรณ์จากบริการตำแหน่งของแพลตฟอร์มและเรียกใช้การค้นหาในบริเวณใกล้เคียง
- แสดงข้อมูลสรุปภาพรวมโดย AI สำหรับสถานที่ที่เฉพาะเจาะจง
- แสดงข้อมูลสรุปเกี่ยวกับพื้นที่ที่ทำงานด้วยระบบ AI ซึ่งอธิบายสถานที่ในพื้นที่รอบๆ สถานที่หนึ่งๆ
- แสดงข้อมูลเกี่ยวกับสถานที่ตามสตริงการค้นหาที่อยู่ตามเส้นทางที่กำหนดไว้ล่วงหน้า
- แสดงระยะทาง ระยะเวลาเดินทาง และ URI เส้นทางไปยังสถานที่ที่ค้นหาด้วยข้อความจากชุดพิกัดละติจูด/ลองจิจูด
- แสดงระยะทาง ระยะเวลาเดินทาง และ URI เส้นทางไปยังสถานที่ใกล้เคียงจากชุดพิกัดละติจูด/ลองจิจูด
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