ย้ายไปที่รายละเอียดสถานที่ (ใหม่)

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 คุณต้องดำเนินการดังนี้

  1. ใส่ Place.Field.DISPLAY_NAME ในรายการช่องของคำขอ ค่านี้จะกำหนดค่าการตอบกลับให้รวมทั้งชื่อสถานที่และรหัสภาษาไว้ในออบเจ็กต์ Place

  2. โทรไปที่ PlacesClient.fetchPlace() PlacesClient.findCurrentPlace() ไม่รองรับช่องรหัสภาษา

  3. ใช้เมธอด Place.getNameLanguageCode() เพื่อเข้าถึงช่องรหัสภาษาในแอบเจ็กต์ Place

ตั้งค่ารหัสภูมิภาค

Places SDK สำหรับ Android (เวอร์ชันใหม่) จะเพิ่มพารามิเตอร์คำขอรหัสภูมิภาคลงในรายละเอียดสถานที่ ระบบจะใช้รหัสภูมิภาคเพื่อจัดรูปแบบการตอบกลับ ซึ่งระบุเป็นค่ารหัส CLDR 2 อักขระ พารามิเตอร์นี้ยังอาจส่งผลต่อผลการค้นหาด้วย ไม่มีค่าเริ่มต้น คุณต้องเปิดใช้ SDK ใหม่เพื่อตั้งค่ารหัสภูมิภาค

หากชื่อประเทศของช่องที่อยู่ในการตอบกลับตรงกับรหัสภูมิภาค ระบบจะไม่ใส่รหัสประเทศไว้ในที่อยู่

รหัส CLDR ส่วนใหญ่เหมือนกับรหัส ISO 3166-1 โดยมีข้อยกเว้นบางประการ เช่น ccTLD ของสหราชอาณาจักรคือ "uk" (.co.uk) ส่วนรหัส ISO 3166-1 คือ "gb" (ในทางเทคนิคสำหรับนิติบุคคล "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ") พารามิเตอร์นี้อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง

ตัวอย่างคำขอ

ดูตัวอย่างที่สมบูรณ์ได้ที่รายละเอียดสถานที่ (ใหม่)