Places SDK สำหรับ Android (เดิม) รองรับรายละเอียดสถานที่ (เดิม) หากคุณคุ้นเคยกับรายละเอียดสถานที่ (เดิม) รายละเอียดสถานที่ (ใหม่) จะทําการเปลี่ยนแปลงต่อไปนี้
ใช้รูปแบบการกำหนดราคาใหม่ ดูข้อมูลราคาสำหรับ API ทั้งหมดได้ที่ การใช้งานและการเรียกเก็บเงิน
คุณต้องเริ่มต้นแอปโดยเรียกใช้เมธอด
Places.initializeWithNewPlacesApiEnabled()ดูข้อมูลเพิ่มเติมเกี่ยวกับการเลือกบริการ Places API ได้ที่ ตั้งค่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Googleต้องมีการมาสก์ฟิลด์ คุณต้องระบุช่องที่ต้องการให้แสดงผล ในการตอบกลับ ไม่มีรายการฟิลด์ที่แสดงผลเริ่มต้น หากคุณละเว้น รายการนี้ เมธอดจะแสดงข้อผิดพลาด
ส่วนต่อไปนี้จะอธิบายการเปลี่ยนแปลงเพิ่มเติม
เข้าถึงประเภทสถานที่ใหม่
สถานที่แต่ละแห่งมีค่าประเภทที่เชื่อมโยงได้มากกว่า 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 คลาสยังมีการระบุแหล่งที่มาและการระบุแหล่งที่มาของผู้เขียนได้ด้วย หาก
คุณแสดงรีวิวในแอป คุณต้องแสดงการระบุแหล่งที่มา
หรือการระบุแหล่งที่มาของผู้เขียนด้วย ดูข้อมูลเพิ่มเติมได้ที่แสดงรีวิว
ดูข้อมูลเพิ่มเติมได้ในเอกสารเกี่ยวกับการระบุแหล่งที่มา
เข้าถึงรหัสภาษาของชื่อสถานที่
ใน Places SDK สำหรับ Android (เดิม)
เมธอด Place.getName()
จะแสดงสตริงข้อความที่มีชื่อของสถานที่ หากต้องการป้อนข้อมูล
Place object ด้วยชื่อสถานที่ คุณต้องใส่
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" (ในทางเทคนิคสำหรับนิติบุคคล "สหราชอาณาจักรบริเตนใหญ่ และไอร์แลนด์เหนือ") พารามิเตอร์นี้อาจส่งผลต่อผลลัพธ์ตามกฎหมายที่เกี่ยวข้อง
ตัวอย่างคำขอ
ดูตัวอย่างทั้งหมดได้ที่รายละเอียดสถานที่ (เดิม)