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

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" (ในทางเทคนิคสำหรับนิติบุคคล "สหราชอาณาจักรบริเตนใหญ่และไอร์แลนด์เหนือ") พารามิเตอร์นี้อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง

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

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