การเลิกใช้งาน

หน้านี้แสดงผลิตภัณฑ์และฟีเจอร์ทั้งหมดของ Google Maps Platform ซึ่งขณะนี้อยู่ในช่วงการเลิกใช้งาน ซึ่งรวมถึงผลิตภัณฑ์ภายใต้แผนที่ เส้นทาง และสถานที่ต่างๆ

วิธีการเลิกใช้งาน

ระยะเวลาการเลิกใช้งานสำหรับผลิตภัณฑ์ ฟีเจอร์ หรือเวอร์ชันจะเริ่มในวันที่ประกาศเรื่องการเลิกใช้งาน ผลิตภัณฑ์ ฟีเจอร์ หรือเวอร์ชันจะยังคงมีให้บริการต่อไปตลอดระยะเวลาการเลิกใช้งาน (โดยทั่วไปคือ 12 เดือน) เมื่อพ้นระยะเวลาการเลิกใช้งานไปแล้ว คาดว่าผลิตภัณฑ์ ฟีเจอร์ หรือเวอร์ชันดังกล่าวจะหยุดให้บริการและไม่มีให้บริการอีกต่อไป

เจ้าของโปรเจ็กต์ที่มีอีเมลที่มีการตรวจสอบจะได้รับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่มีผลต่อแต่ละโปรเจ็กต์ของตน รับทราบข้อมูลอยู่เสมอเกี่ยวกับการอัปเดตที่สำคัญ การเลิกใช้งาน และการเปลี่ยนแปลงอื่นๆ

การเลิกใช้งานในเวอร์ชัน SDK

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับความพร้อมให้บริการของเวอร์ชัน Maps JavaScript API ซึ่งเป็นไปตามกำหนดการเปิดตัวรายไตรมาสและการเลิกใช้งาน

ดูคำแนะนำเกี่ยวกับการจัดการทรัพยากร Dependency ของเวอร์ชันด้วย Maps SDK สำหรับ Android, Maps SDK สำหรับ iOS, Places SDK สำหรับ Android และ Places SDK สำหรับ iOS

การเลิกใช้งานที่ใช้งานอยู่

ส่วนนี้จะแสดงผลิตภัณฑ์และฟีเจอร์ทั้งหมดที่อยู่ในระยะการเลิกใช้งาน


google.maps.marker ใน Maps JavaScript API (เลิกใช้งานตั้งแต่เดือนกุมภาพันธ์ 2023)

เครื่องหมายขั้นสูง (google.maps.marker.AdvancedmarkerElement) ดีกว่า google.maps.marker ในเกือบทุกด้าน ใช้งานง่ายขึ้น มีประสิทธิภาพมากกว่า เข้าถึงได้มากกว่า มีฟีเจอร์มากมายและปรับแต่งได้มากขึ้น google.maps.marker ใน Maps JavaScript API เลิกใช้งานไปแล้วตั้งแต่ 3.56

สิ่งที่ต้องทำ Maps JavaScript API เวอร์ชันต่ำสุดที่มี google.maps.marker.AdvancedmarkerElement คือ 3.53.2 ในตอนนี้ยังไม่มีกำหนดการเลิกให้บริการ google.maps.marker แต่ขอแนะนำให้ใช้ google.maps.marker.Advanced MarkerElement มากกว่า google.maps.marker แม้ว่า google.maps.marker จะยังได้รับการแก้ไขข้อบกพร่องสำหรับการถดถอยครั้งใหญ่ต่อไป แต่ข้อบกพร่องที่มีอยู่แล้วใน google.maps.marker จะไม่ได้รับการแก้ไข เราจะแจ้งให้คุณทราบล่วงหน้าอย่างน้อย 12 เดือนก่อนที่การสนับสนุนจะสิ้นสุดลง


ขอบเขต สถานที่ตั้ง และรัศมีในบริการเติมข้อความอัตโนมัติสถานที่ของ Maps JavaScript API (เลิกใช้งานตั้งแต่เดือนพฤษภาคม 2023)

บริการเติมข้อความอัตโนมัติสถานที่ใน Maps JavaScript API จะเลิกใช้งานตัวเลือกคำขอต่อไปนี้ตั้งแต่เดือนพฤษภาคม 2023 ได้แก่ ขอบเขต สถานที่ตั้ง และรัศมี โปรดใช้ locationBias และ locationRestriction แทน

ฟีเจอร์นี้จะใช้งานได้ต่อไปและเราจะแจ้งให้ทราบล่วงหน้า 12 เดือนก่อนที่การสนับสนุนจะสิ้นสุดลง


ไลบรารีบริบทเฉพาะเครื่อง, Maps JavaScript API (เลิกใช้งานแล้วตั้งแต่ v3.51.2)

เนื่องจากมีการใช้ฟีเจอร์เบต้านี้แบบจำกัด เราจึงเลิกใช้งานไลบรารีบริบทเฉพาะที่ไปตั้งแต่ v3.51.2 คลังบริบทในพื้นที่จะหยุดให้บริการในเดือนมกราคม 2024 ในระหว่างนี้ เราจะมีการแก้ไขข้อบกพร่องและเหตุการณ์หลักๆ เพิ่มเติม

หากคุณสนใจสร้างประสบการณ์การใช้งานเหมือนไลบรารีบริบทเฉพาะที่ด้วยตัวคุณเอง เราขอแนะนำให้ลองใช้โซลูชัน "การค้นพบย่านใกล้เคียง" ในเครื่องมือสร้างด่วน หรือใช้ไลบรารีสถานที่ Maps JavaScript API ตัวอย่างโค้ดและ Codelab สำหรับไลบรารีสถานที่ช่วยคุณได้


ไลบรารีความเข้ากันได้ของ Places สำหรับ Places SDK สำหรับ Android (ข้อมูล ณ วันที่ 31 มีนาคม 2022)

เราจะเลิกใช้งานไลบรารีความเข้ากันได้กับ Places ทุกเวอร์ชันสำหรับ Places SDK สำหรับ Android ในวันที่ 31 มีนาคม 2022 เรากำลังพัฒนาไลบรารีความเข้ากันได้กับ Places ใน Places SDK สำหรับ Android เวอร์ชัน 2.6.0 (ซึ่งระบุทรัพยากร Dependency เป็น com.google.android.libraries.places:places-compat:2.6.0) เรียบร้อยแล้ว

ไลบรารีเวอร์ชันใหม่จะไม่ได้รับการเผยแพร่หลังจากวันที่ดังกล่าว วิธีเดียวที่จะเข้าถึงฟีเจอร์และการแก้ไขข้อบกพร่องใน Places SDK สำหรับ Android เวอร์ชันสูงกว่า 2.6.0 ก็คือการใช้ Places SDK สำหรับ Android

ไลบรารีความเข้ากันได้ของ Places เปิดตัวเมื่อเดือนมกราคม 2019 เพื่ออำนวยความสะดวกในการย้ายข้อมูลจาก SDK เดิม (มีให้บริการในบริการ Play) ไปเป็น Places SDK แบบสแตนด์อโลนสำหรับ Android

ทำตามคำแนะนำในการย้ายข้อมูล เพื่อใช้ Places SDK สำหรับ Android โดยตรง รหัสสถานะ ชื่อวิธีการ และชื่อคลาสของการเติมข้อความอัตโนมัติบางรายการแตกต่างกันระหว่างไลบรารีความเข้ากันได้ของ Places และ Places SDK สำหรับ Android ดูเอกสารเวอร์ชันสำหรับการระบุและรักษาทรัพยากร Dependency ในเวอร์ชันต่างๆ ของ Places SDK สำหรับ Android

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


การปรับปรุงนโยบายรักษาความปลอดภัยเนื้อหา (21 มีนาคม 2022 - พฤษภาคม 2023)

การรองรับเว็บไซต์ที่ใช้นโยบายรักษาความปลอดภัยเนื้อหา (CSP) ที่ไม่ได้ระบุ googleapis.com ใน Maps JavaScript API จะเลิกใช้งานตั้งแต่ v3.49 และจะไม่รองรับตั้งแต่ v3.50 เราจะยกเลิกเวอร์ชันที่รองรับล่าสุดอย่าง v3.49 ในไตรมาสที่ 2 ปี 2023 หลังจากนั้น Maps JavaScript API จะปฏิเสธคำขอทั้งหมดที่ใช้คําสั่ง CSP ที่ไม่ได้ระบุ googleapis.com

หากต้องการหลีกเลี่ยงไม่ให้ประสบการณ์การใช้งานเว็บไซต์หยุดชะงัก โปรดระบุ googleapis.com ใน CSP Maps JavaScript API ทุกเวอร์ชันที่พร้อมใช้งานในปัจจุบันรองรับ CSP


บริการเกม Google Maps Platform (18 ตุลาคม 2021 - 31 ธันวาคม 2022)

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


รหัสสถานที่ที่ล้าสมัย (16-30 มีนาคม 2022)

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


โมดูล Maps ใน google.load (13 ตุลาคม 2020 - 13 ตุลาคม 2021)

บริการที่ให้โมดูล "Maps" สำหรับ google.load เลิกใช้งานแล้วตั้งแต่วันที่ 13 ตุลาคม 2020 และจะปิดให้บริการในวันที่ 13 ตุลาคม 2021 คำขอโหลดโมดูล "Maps" ใน google.load ในภายหลังจะทำให้เกิดข้อผิดพลาด และจะไม่มีการโหลดแผนที่ ดูข้อมูลเพิ่มเติมได้ที่คำแนะนำในการย้ายข้อมูล


ตอนนี้ Places SDK สำหรับ iOS GMSPlaceField ใช้มาโคร NS_OPTIONS (เวอร์ชัน v4.0.0) แล้ว

เริ่มจาก Places SDK สำหรับ iOS v4.0.0 ตอนนี้ GMSPlaceField จะใช้มาโคร NS_OPTIONS แทน NS_ENUM เพื่อการรองรับ Swift ที่ดีขึ้น อ่านเพิ่มเติมเกี่ยวกับการย้ายข้อมูลไปยัง GMSPlaceField เป็น NS_OPTIONS

หากต้องการใช้ GMSPlaceField เป็น NS_ENUM ต่อไป ให้ระบุ v3.10.0 หรือเวอร์ชันก่อนหน้าในทรัพยากร Dependency


Places SDK สำหรับเมธอดของ iOS: setAutocompleteBoundsUsingNortheastCorner:SouthWestCorner, initWithBounds:filter (v3.10.0 - v4.0.0)

เราเลิกใช้งานเมธอดตัวช่วย setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner ไปแล้วตั้งแต่ v3.10.0 และไม่รองรับใน v4.0.0 ขึ้นไป แต่ให้ใช้ locationBias หรือ locationRestriction แทน

เราเลิกใช้งานเมธอด initWithBounds:filter ไปแล้วตั้งแต่ v3.10.0 และไม่รองรับใน v4.0.0 ขึ้นไป ให้ใช้ initWithFilter: ใน GMSAutocompleteFetcher แทน

เวอร์ชันที่รองรับสูงสุดสำหรับเมธอดที่เลิกใช้งานแล้วเหล่านี้คือ v3.10.0

โปรดดูรายละเอียดเกี่ยวกับวิธีการเปลี่ยนทดแทนที่หัวข้อภาคผนวก 1


GMSCoordinateBounds ในการเติมข้อความอัตโนมัติในสถานที่ (v3.9.0 - v4.0.0)

พร็อพเพอร์ตี้/พารามิเตอร์หลายรายการที่ใช้ GMSCoordinateBounds ใน Places SDK สำหรับบริการเติมข้อความอัตโนมัติของ iOS เลิกใช้งานไปแล้วตั้งแต่ v3.9.0 และไม่รองรับใน v4.0.0 ขึ้นไป เวอร์ชันที่รองรับสูงสุดสำหรับพร็อพเพอร์ตี้/พารามิเตอร์ที่เลิกใช้งานแล้วคือ v3.10.0

ขอบเขตใน GMSAutocompleteViewController

พร็อพเพอร์ตี้ GMSAutocompleteViewController ต่อไปนี้เลิกใช้งานแล้ว

เพื่อฟังก์ชันการทำงานที่เทียบเท่ากัน ให้ใช้ GMSAutocompleteViewController.autocompleteFilter กับ GMSAutocompleteFilter.locationBias หรือ GMSAutocompleteFilter.locationRestriction Places SDK เวอร์ชันต่ำสุดสำหรับ iOS ที่มีพร็อพเพอร์ตี้สำหรับแทนที่เหล่านี้คือ v3.8.0

ขอบเขตใน findAutocompletePredictionsFromQuery และ autocompleteQuery

เพื่อฟังก์ชันการทำงานที่เทียบเท่ากัน ให้ใช้ findAutocompletePredictionsFromQuery:filter:sessionToken:callback กับ GMSAutocompleteFilter.locationBias หรือ GMSAutocompleteFilter.locationRestriction เวอร์ชันล่าสุดของ Places SDK สำหรับ iOS ที่มีพร็อพเพอร์ตี้สำหรับแทนที่เหล่านี้คือ v3.8.0

โปรดดูรายละเอียดเกี่ยวกับวิธีการเปลี่ยนทดแทนที่หัวข้อภาคผนวก 1


ฟิลด์สถานที่ GMSPlace.openNowStatus (v3.0.0 - v4.0.0)

ช่อง/พร็อพเพอร์ตี้ Places GMSPlace.openNowStatus ใน Places SDK สำหรับ iOS เลิกใช้งานแล้วตั้งแต่ v3.0.0 และไม่รองรับใน v4.0.0 ขึ้นไป เวอร์ชันที่รองรับสูงสุดสำหรับช่องที่เลิกใช้งานแล้วคือ v3.10.0

แต่ให้ใช้ฟังก์ชัน GMSPlace.isOpen หรือ GMSPlace.isOpenAtDate แทน เวอร์ชันล่าสุดของ Places SDK สำหรับ iOS ที่มีฟังก์ชันการแทนที่เหล่านี้คือ v3.3.0


ช่องสถานที่: permanently_closed (เลิกใช้งานวันที่ 26 พฤษภาคม 2020)

ช่อง Places permanently_closed ใน Places API และ Places Library, Maps JavaScript API เลิกใช้งานแล้วและไม่ควรนำมาใช้ แต่ให้ใช้ business_status (Places API) หรือ business_status (Places Library) แทน เพื่อดูสถานะการดำเนินการของธุรกิจ Maps JavaScript API เวอร์ชันต่ำสุดของ Places Library ที่ใช้ business_status คือ v3.40


ช่องสถานที่ open_now, utc_offset (เลิกใช้งานเมื่อวันที่ 20 พฤศจิกายน 2019)

ช่อง Places open_now และ utc_offset ในไลบรารีของ Places, Maps JavaScript API ได้เลิกใช้งานแล้วตั้งแต่วันที่ 20 พฤศจิกายน 2019 และไม่ควรใช้งาน

ช่องเหล่านี้จะมีการเลิกใช้งานเฉพาะใน Places Library, Maps JavaScript API

  • ช่อง open_now ถูกแทนที่ด้วย PlaceResult.opening_hours.isOpen() ในรายละเอียดสถานที่ สำหรับการค้นหาใกล้เคียงและการค้นหาข้อความ ให้ใช้พารามิเตอร์คำขอ openNow:true เพื่อกรองสถานที่ที่เปิดอยู่ในปัจจุบัน ไม่มีการระบุค่าที่เทียบเท่าสำหรับค้นหาสถานที่ ในการรับค่านี้ คุณต้องส่งคำขอรายละเอียดสถานที่
  • ช่อง utc_offset ถูกแทนที่ด้วย PlaceResult.utc_offset_minutes ในรายละเอียดสถานที่

โปรดดูข้อมูลเพิ่มเติมที่การย้ายข้อมูลช่องสถานที่


Maps JavaScript API: google.maps.event.addDomListener() และ google.maps.event.addDomListenerOnce() (เลิกใช้งานเมื่อวันที่ 7 เมษายน 2022)

ฟังก์ชัน [google.maps.event.addDomListener()](/maps/documentation/javascript/reference/event#event.addDomListener) และ [google.maps.event.addDomListenerOnce()](/maps/documentation/javascript/reference/event#event.addDomListenerOnce) ใน Maps JavaScript API เลิกใช้งานแล้วและไม่ควรนำมาใช้ แต่ให้ใช้เมธอด addEventListener() มาตรฐานแทน

วิธีการเหล่านี้จะยังคงใช้ได้ต่อไปและไม่มีแผนที่จะยกเลิกการใช้งาน


การเลิกใช้งานที่เสร็จสมบูรณ์

ส่วนนี้จะแสดงผลิตภัณฑ์และฟีเจอร์ทั้งหมดที่เลิกใช้งานแล้ว ผลิตภัณฑ์และฟีเจอร์เหล่านี้จะไม่มีให้บริการอีกต่อไป


Maps SDK สำหรับ iOS เวอร์ชัน 2.5 และต่ำกว่า (มกราคม 2022 - มกราคม 2023)

Maps SDK สำหรับ iOS เวอร์ชัน 2.5 และต่ำกว่าได้เลิกให้บริการในเดือนมกราคม 2023 ซึ่งช่วยเพิ่มระบบปฏิบัติการขั้นต่ำที่ Maps SDK สำหรับ iOS รองรับเป็น iOS 8 และ IDE ขั้นต่ำที่รองรับเป็น Xcode 8

เราขอแนะนำให้คุณระบุและใช้ Maps SDK เวอร์ชันล่าสุดสำหรับ iOS


Maps JavaScript API v2 (19 พฤษภาคม 2010 - 26 พฤษภาคม 2021)

Maps JavaScript API เวอร์ชัน 2 จะใช้งานไม่ได้อีกต่อไปตั้งแต่วันที่ 26 พฤษภาคม 2021 ด้วยเหตุนี้ แผนที่ v2 ของเว็บไซต์คุณจึงหยุดทำงานและแสดงข้อผิดพลาด JavaScript หากต้องการใช้แผนที่บนเว็บไซต์ต่อไป ให้เปลี่ยนไปใช้ Maps JavaScript API v3 ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปเกรดแอปพลิเคชัน Maps JavaScript API จาก v2 เป็น v3


ช่องสถานที่: reference, id, alt_id, scope (3 กันยายน 2019 - 10 สิงหาคม 2020)

ช่องสถานที่ id, alt_id และ scope จะใช้งานไม่ได้อีกต่อไปตั้งแต่วันที่ 10 สิงหาคม 2020 ช่องสถานที่ reference เลิกใช้งานแล้วและไม่ควรนำมาใช้

  • ช่องตอบกลับ id ถูกแทนที่ด้วยช่องคำตอบ place_id แล้ว
  • ระบบได้แทนที่ช่องคำตอบ reference ด้วยการตอบกลับ place_id แล้ว ซึ่งไม่ควรใช้
  • ช่อง alt_id และ scope ไม่มีค่าเทียบเท่า เนื่องจากใช้สําหรับบริการเพิ่มสถานที่ซึ่งปิดให้บริการในเดือนกรกฎาคม 2018 เท่านั้น

โปรดดูรายละเอียดที่หัวข้อการย้ายข้อมูลช่องสถานที่


iOS เวอร์ชัน 10, สถาปัตยกรรม ARMv7 แบบ 32 บิตใน Maps SDK สำหรับ iOS 5.0

ตั้งแต่ Maps SDK สำหรับ iOS เวอร์ชัน 5.0 เป็นต้นไป ระบบไม่รองรับ iOS 10 และ ARMv7 สถาปัตยกรรม 32 บิตอีกต่อไป

Places SDK สำหรับ iOS

การเปิดตัว Places SDK สำหรับ iOS 5.0 นั้น GMSCoordinateBounds จะยุติการให้บริการ ซึ่งแทนที่ด้วย GMSPlacesViewportInfo

เลเยอร์ตารางฟิวชัน (ทดลอง) (3 ธันวาคม 2018 - 3 ธันวาคม 2019)

เลเยอร์ตารางฟิวชันใน Maps JavaScript API ถูกปิดไปเมื่อวันที่ 3 ธันวาคม 2019 และไม่พร้อมใช้งานตั้งแต่เวอร์ชัน 3.38 (3.37 คือเวอร์ชันล่าสุดที่รองรับตารางฟิวชัน) ดูข้อมูลเพิ่มเติม


Places SDK สำหรับ Android และ iOS (29 มกราคม 2019 - 29 กรกฎาคม 2019)

นับตั้งแต่วันที่ 29 มกราคม 2019 Places SDK ที่อัปเกรดสำหรับ Android และ iOS เข้ามาแทนที่ Places SDK เวอร์ชันเดิม Places SDK เวอร์ชันปัจจุบันสำหรับ iOS, Places SDK สำหรับ Android และเครื่องมือเลือกสถานที่ได้เลิกใช้งานไปแล้วเมื่อวันที่ 29 มกราคม 2019 และปิดใช้ไปแล้วเมื่อวันที่ 29 กรกฎาคม 2019


เพิ่มและลบสถานที่ (30 มิถุนายน 2017 - 30 มิถุนายน 2018)

นับตั้งแต่วันที่ 30 มิถุนายน 2018 เราได้ปิดฟีเจอร์ "เพิ่มสถานที่" และ "ลบสถานที่" และจะใช้งานไม่ได้อีกต่อไป


ระบบไม่สนับสนุนคำค้นหาเกี่ยวกับสถานที่ ใน Places API และไลบรารี Places, Maps JavaScript API (31 มีนาคม 2022 - 31 มีนาคม 2023)

เราเลิกใช้งาน Maps JavaScript API แล้วตั้งแต่วันที่ 31 มีนาคม 2022 และจะได้รับการตอบกลับข้อผิดพลาด INVALID_REQUEST รายการตั้งแต่วันที่ 31 มีนาคม 2023 เป็นต้นไป คำค้นหาสถานที่ที่ระบบไม่รองรับสำหรับการค้นหาข้อความ การค้นหาใกล้เคียง และค้นหาสถานที่ใน Places API และไลบรารี Places

Places API และไลบรารี Places, Maps JavaScript API รองรับการค้นหาสถานที่ 3 วิธีด้วยกัน ได้แก่ การค้นหาข้อความ การค้นหาใกล้เคียง และค้นหาสถานที่ แต่ละวิธีจะยอมรับคำขอที่มีพารามิเตอร์แบบผสมและระบบรองรับ และปฏิเสธคำขอส่วนใหญ่ที่มีชุดพารามิเตอร์ที่ไม่รองรับ

คู่ของพารามิเตอร์ที่ไม่รองรับบางชุดไม่ได้ถูกปฏิเสธอย่างถูกต้องมาจนถึงปัจจุบัน

  • คำขอการค้นหาข้อความที่ไม่มีพารามิเตอร์ query ที่ว่างเปล่า และไม่มีพารามิเตอร์ type ที่รองรับ
  • คำขอการค้นหาข้อความกับ query=*
  • คำขอการค้นหาใกล้เคียงกับ keyword=*
  • คำขอการค้นหาใกล้เคียงกับ name=*
  • หาคำขอสถานที่กับ input=*

คำขอ Place Search ที่ไม่รองรับเหล่านี้ต้องแทนที่ด้วยสิ่งใดสิ่งหนึ่งต่อไปนี้

  • คำขอการค้นหาใกล้เคียงที่ไม่มีพารามิเตอร์ keyword (หรือ name) สามารถใช้เพื่อค้นหาสิ่งก่อสร้างใกล้เคียงได้ ขอแนะนำให้ใช้พารามิเตอร์ type กับประเภทที่รองรับ 1 ประเภทด้วย (ดูตารางที่ 1: ประเภทสถานที่) ซึ่งให้การจับคู่ลักษณะการทํางานปัจจุบันของคําขอค้นหาข้อความที่มีพารามิเตอร์ query ว่างเปล่าหรือขาดหายไปมากที่สุด

  • API การระบุพิกัดทางภูมิศาสตร์ สามารถใช้คำขอที่มีพารามิเตอร์ latlng เพื่อค้นหาที่อยู่ที่ใกล้ที่สุด ซึ่งจะให้การจับคู่ที่ใกล้เคียงกับลักษณะการทำงานในปัจจุบันของ

    • คำขอการค้นหาข้อความกับ query=*
    • คำขอการค้นหาใกล้เคียงกับ keyword=*
    • คำขอการค้นหาใกล้เคียงกับ name=*
    • หาคำขอสถานที่กับ input=*

ภาคผนวก 1: สรุปการแทนที่ API ของ Places SDK สำหรับ iOS ที่เลิกใช้งานแล้ว

ตารางต่อไปนี้แสดงวิธีการแทนที่ที่ใช้สำหรับวิธีการหรือพร็อพเพอร์ตี้ที่เลิกใช้งานแล้วแต่ละรายการ

วิธีการ/พร็อพเพอร์ตี้ที่เลิกใช้งานแล้ว ใช้แทน
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(ใน GMSAutocompleteViewController)
locationRestriction และ locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(ใน GMSAutocompleteResultsViewController)
locationRestriction และ locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(ใน GMSAutocompleteTableDataSource)
locationRestriction และ locationBias
initWithBounds:filter
(ใน GMSAutocompleteFetcher)
initWithFilter:
autocompleteBounds และ autocompleteBoundsMode
(ใน GMSAutocompleteViewController)
GMSAutocompleteViewController.autocompleteFilter กับ locationBias หรือ locationRestriction
findAutocompletePredictionsFromQuery:bounds:boundsMode:filter:SessionToken:callback, autocompleteQuery:bounds:filter:callback และ autocompleteQuery:bounds:boundsMode:filter:callback
(ใน GMSPlacesClient)
findAutocompletePredictionsFromQuery:filter:sessionToken:callback กับ locationBias หรือ locationRestriction

Places SDK เวอร์ชันต่ำสุดสำหรับ iOS ที่มีพร็อพเพอร์ตี้สำหรับแทนที่คือ v3.8.0