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

นักพัฒนาแอปในเขตเศรษฐกิจยุโรป (EEA)

Places SDK สำหรับ Android รองรับรายละเอียดสถานที่ (เดิม) หากคุณคุ้นเคยกับ Places SDK สำหรับ Android (เดิม) รายละเอียดสถานที่ (ใหม่) จะทำการเปลี่ยนแปลงต่อไปนี้

  • ใช้รูปแบบการกำหนดราคาใหม่ ดูข้อมูลราคาสำหรับ API ทั้งหมดได้ที่ Places SDK สำหรับ Android (ใหม่)

  • คุณต้องเริ่มต้นแอปโดยการเรียกใช้เมธอด Places.initializeWithNewPlacesApiEnabled() ดูข้อมูลเพิ่มเติมเกี่ยวกับการเลือกบริการ Places API ได้ที่ ตั้งค่าโปรเจ็กต์ Google Cloud

  • ต้องมีการมาสก์ฟิลด์ คุณต้องระบุช่องที่ต้องการให้แสดงผล ในการตอบกลับ ไม่มีรายการฟิลด์ที่แสดงผลเริ่มต้น หากคุณละเว้น รายการนี้ เมธอดจะแสดงข้อผิดพลาด

ส่วนต่อไปนี้จะอธิบายการเปลี่ยนแปลงเพิ่มเติม

เข้าถึงประเภทสถานที่ใหม่

สถานที่แต่ละแห่งอาจมีค่าประเภทที่เชื่อมโยงอย่างน้อย 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 คุณต้องทำดังนี้

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

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

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