Places SDK สำหรับ Android รองรับ รายละเอียดสถานที่ที่มีอยู่ หากคุณคุ้นเคยกับ Places SDK สำหรับ Android ที่มีอยู่ รายละเอียดสถานที่เวอร์ชันใหม่จะมีการเปลี่ยนแปลงต่อไปนี้
ใช้รูปแบบการกำหนดราคาใหม่ ดูข้อมูลราคาสำหรับ API ทั้งหมดได้ที่ Places SDK สําหรับ Android (ใหม่)
คุณต้องเริ่มต้นแอปโดยเรียกใช้เมธอด
Places.initializeWithNewPlacesApiEnabled()ดูข้อมูลเพิ่มเติมเกี่ยวกับการเลือกบริการ Places API ได้ที่หัวข้อตั้งค่าโปรเจ็กต์ Google Cloudต้องทำการมาสก์ฟิลด์ คุณต้องระบุช่องที่ต้องการให้แสดงในการตอบกลับ ไม่มีรายการเริ่มต้นของฟิลด์ที่แสดงผล หากคุณละเว้นรายการนี้ เมธอดจะแสดงข้อผิดพลาด
ส่วนต่อไปนี้จะอธิบายการเปลี่ยนแปลงเพิ่มเติม
เข้าถึงสถานที่ประเภทใหม่
สถานที่แต่ละแห่งมีค่า type อย่างน้อย 1 ค่าที่เชื่อมโยงอยู่ Places SDK สําหรับ Android เวอร์ชัน 3.3.0 ขึ้นไปจะเพิ่มค่าประเภทใหม่ๆ มากมาย โปรดดูรายการที่สมบูรณ์ที่หัวข้อประเภทสถานที่แบบขยาย
เมธอด Place.getPlaceTypes() จะแสดงผลค่าประเภทเป็นรายการค่าสตริง ค่าที่แสดงจะขึ้นอยู่กับเวอร์ชันของ Places SDK สำหรับ Android ดังนี้
Places SDK สำหรับ Android (ใหม่): แสดงผลสตริงที่กําหนดโดยตาราง ก และตาราง ข ที่แสดงในประเภทสถานที่ (ใหม่) รวมถึงประเภทสถานที่ทั้งหมดที่เพิ่มในเวอร์ชัน 3.3.0
Places SDK สําหรับ Android: แสดงผล Enum ที่กําหนดโดย
Place.Typesซึ่งไม่รวมประเภทใหม่ที่เพิ่มในเวอร์ชัน 3.3.0 ขึ้นไป
เข้าถึงรีวิวสถานที่
Places SDK สำหรับ Android (เวอร์ชันใหม่) จะเพิ่มคลาส
Review
ซึ่งมีรีวิวสถานที่ ออบเจ็กต์ Place อาจมีรีวิวได้สูงสุด 5 รายการ
คลาส Review ยังมีแหล่งที่มาและการระบุแหล่งที่มาของผู้เขียนได้ด้วย หากแสดงรีวิวในแอป คุณต้องแสดงการระบุแหล่งที่มาหรือการระบุแหล่งที่มาของผู้เขียนด้วย ดูข้อมูลเพิ่มเติมได้ที่แสดงรีวิว
ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับการระบุแหล่งที่มา
เข้าถึงรหัสภาษาของชื่อสถานที่
เมธอดที่มีอยู่ของ Place.getName() จะแสดงผลสตริงข้อความที่มีชื่อสถานที่ หากต้องการป้อนข้อมูลในออบเจ็กต์ Place ด้วยชื่อสถานที่ คุณต้องใส่ Place.Field.DISPLAY_NAME ในรายการช่องของคำขอรายละเอียดสถานที่
ตอนนี้ออบเจ็กต์ Place มีรหัสภาษาสำหรับสตริงชื่อแล้ว หากต้องการป้อนข้อมูลรหัสภาษาลงในออบเจ็กต์ Place คุณต้องดำเนินการดังนี้
ใส่
Place.Field.DISPLAY_NAMEในรายการช่องของคําขอ ค่านี้จะกำหนดค่าการตอบกลับให้รวมทั้งชื่อสถานที่และรหัสภาษาไว้ในออบเจ็กต์Placeโทรไปที่
PlacesClient.fetchPlace()PlacesClient.findCurrentPlace()ไม่รองรับช่องรหัสภาษาใช้เมธอด
Place.getNameLanguageCode()เพื่อเข้าถึงช่องรหัสภาษาในออบเจ็กต์Place
ตั้งค่ารหัสภูมิภาค
Places SDK สำหรับ Android (เวอร์ชันใหม่) จะเพิ่มพารามิเตอร์คำขอรหัสภูมิภาคลงในรายละเอียดสถานที่ ระบบจะใช้รหัสภูมิภาคเพื่อจัดรูปแบบการตอบกลับ ซึ่งระบุเป็นค่ารหัส CLDR 2 อักขระ พารามิเตอร์นี้ยังส่งผลต่อผลการค้นหาด้วย ไม่มีค่าเริ่มต้น คุณต้องเปิดใช้ SDK ใหม่เพื่อตั้งค่ารหัสภูมิภาค
หากชื่อประเทศของช่องที่อยู่ในการตอบกลับตรงกับรหัสภูมิภาค ระบบจะไม่ใส่รหัสประเทศไว้ในที่อยู่
รหัส CLDR ส่วนใหญ่จะเหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นบางประการ เช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ส่วนรหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับนิติบุคคล "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ") พารามิเตอร์นี้อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง
ตัวอย่างคำขอ
ดูตัวอย่างที่สมบูรณ์ได้ที่รายละเอียดสถานที่ (ใหม่)