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

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

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

วิธีการทํางานของการเลิกใช้งาน

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

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

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

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

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

ดูคําแนะนําในการจัดการทรัพยากร Dependency ด้วย Maps SDK สําหรับ Android, Maps SDK สําหรับ iOS, Places SDK สําหรับ Android และ Places SDK สําหรับ iOS

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

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


ไลบรารีความเข้ากันได้ของ 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 Services) ไปยัง Places SDK แบบสแตนด์อโลนสําหรับ Android

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

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


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

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

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

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

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

คําขอการค้นหาสถานที่ที่ไม่ได้รับการสนับสนุนเหล่านี้จะต้องแทนที่ด้วยค่าใดค่าหนึ่งต่อไปนี้

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

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

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

การปรับปรุงนโยบายรักษาความปลอดภัยเนื้อหา (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 มีนาคม 2021 - 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: setsetcompletecompleteBoundsNorthEastCorner: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


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

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


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

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

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

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

ดูข้อมูลเพิ่มเติมในการย้ายข้อมูลช่อง Places


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 JavaScript API v2 (19 พฤษภาคม 2010 - 26 พฤษภาคม 2021)

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


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

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

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

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


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

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

Places SDK สำหรับ iOS

เมื่อเปิดตัว SDK ของ Places สําหรับ iOS 5.0 เราจึงเลิกใช้งาน GMSCoordinateBounds ซึ่งแทนที่ด้วย GMSPlacesViewportInfo

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

ปิด Fusion Tables Layer ใน 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 เราได้ปิดฟีเจอร์การเพิ่มสถานที่และลบสถานที่ และจะใช้งานไม่ได้อีกต่อไป


ภาคผนวก 1: สรุป Places SDK สําหรับการเปลี่ยน API ที่เลิกใช้แล้วใน 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