ย้ายการตอบกลับ Places API

รูปแบบการตอบกลับของ API รายละเอียดสถานที่, การค้นหาในพื้นที่ และการค้นหาข้อความใหม่แตกต่างจากรูปแบบของ API ที่มีอยู่ ความแตกต่างหลักคือรูปแบบของออบเจ็กต์ Place ที่แต่ละเมธอดแสดงผล ตามที่อธิบายไว้ในการเปลี่ยนแปลงออบเจ็กต์สถานที่ในการตอบกลับ

นอกจากนี้ ฟิลด์ระดับบนสุดของออบเจ็กต์การตอบกลับก็เปลี่ยนไปด้วยสำหรับ API แต่ละรายการ โปรดดูหัวข้อต่อไปนี้

การเปลี่ยนแปลงออบเจ็กต์สถานที่ของการตอบกลับ

ตารางนี้แสดงการเปลี่ยนแปลงของออบเจ็กต์ Place ใหม่ในการตอบกลับสำหรับรายละเอียดสถานที่ (ใหม่), การค้นหาในพื้นที่ (ใหม่) และการค้นหาข้อความ (ใหม่) เมื่อเทียบกับออบเจ็กต์ Place ที่มีอยู่

ออบเจ็กต์การตอบกลับใหม่ใช้ตัวหุ้มอูฐสำหรับชื่อช่อง มีช่องใหม่ และเปลี่ยนชื่อฟิลด์ที่มีอยู่บางฟิลด์

ช่อง ออบเจ็กต์สถานที่ที่มีอยู่ ออบเจ็กต์สถานที่ใหม่ หมายเหตุ
คอมโพเนนต์ที่อยู่ address_components addressComponents
วางที่อยู่ Microformat adr_address adrFormatAddress
สถานะธุรกิจ business_status businessStatus
เวลาทำการของสัปดาห์หน้า current_opening_hours currentOpeningHours
บทสรุปบรรณาธิการ editorial_summary editorialSummary
ที่อยู่ที่จัดรูปแบบ formatted_address formattedAddress
หมายเลขโทรศัพท์ในประเทศ formatted_phone_number nationalPhoneNumber
ตำแหน่ง geometry.location location
วิวพอร์ต geometry.viewport viewport
การแสดงที่มาของสถานที่ html_attributions attributions ฟิลด์ระดับบนสุดของการตอบกลับใน API ที่มีอยู่
URL ของไอคอน icon นำออกแล้ว ใช้ iconMaskBaseUri และ iconBackgroundColor ดูข้อมูลเพิ่มเติมที่ไอคอนสถานที่
สีพื้นหลังไอคอน icon_background_color iconBackgroundColor
URL มาสก์ไอคอน icon_mask_base_uri iconMaskBaseUri
หมายเลขโทรศัพท์ระหว่างประเทศ international_phone_number internationalPhoneNumber
ข้อความชื่อสถานที่ name displayName ตอนนี้ชื่อสถานที่แบบข้อความจะเข้าถึงได้ในรูปแบบ displayName.text และ language จะเข้าถึงได้ในรูปแบบ displayName.languageCode
เวลาทำการ opening_hours regularOpeningHours
Photos photos photos รูปแบบของ photos มีการเปลี่ยนแปลงในออบเจ็กต์ Place เวอร์ชันใหม่ สำหรับข้อมูลเพิ่มเติม โปรดดู เปลี่ยนเป็นรูปภาพอ้างอิง
รหัสสถานที่ place_id id
Plus Code plus_code plusCode
ระดับราคา price_level priceLevel
Rating rating rating
การตรวจสอบ reviews reviews
เวลาทำการรองสำหรับสัปดาห์หน้านับจากวันนี้ พร้อมข้อยกเว้นและข้อมูลอื่นๆ ทั้งหมด secondary_opening_hours currentSecondaryOpeningHours
ประเภทสถานที่ types types
URL ของ Google Maps ของสถานที่ url googleMapsUri
จำนวนการให้คะแนนของผู้ใช้ user_ratings_total userRatingCount
ความต่างเวลา UTC utc_offset utcOffsetMinutes
ที่อยู่แบบสั้น ซึ่งประกอบด้วยชื่อถนนและเมือง vicinity shortFormattedAddress
เว็บไซต์ของสถานที่ website websiteUri
ข้อมูลการรองรับเก้าอี้รถเข็น wheelchair_accessible_entrance accessibilityOptions ขณะนี้ wheelchair_accessible_entrance อยู่ที่ accessibilityOptions.wheelchairAccessibleEntrance
แอตทริบิวต์สถานที่ takeout, delivery, dine_in, curbside_pickup, reservable, serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine, serves_brunch, serves_vegetarian_food takeout, delivery, dineIn, curbsidePickup, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, servesBrunch, servesVegetarianFood
ชื่อทรัพยากร ฟิลด์ name ในรูปแบบ places/PLACE_ID ใน API ที่มีอยู่ ช่อง name มี เป็นสตริงข้อความ ใน API ใหม่ ข้อมูลดังกล่าวจะอยู่ใน displayName
ประเภทสถานที่หลัก primaryTypeName ใหม่
วางประเภทหลักเป็นสตริงข้อความ primaryTypeDisplayName ใหม่
เวลาทำการปกติของสัปดาห์รอง อาจมีข้อยกเว้นและอื่นๆ ทั้งหมด ข้อมูล regularSecondaryOpeningHours ใหม่
ตัวเลือกการชำระเงินที่สถานที่นี้ยอมรับ paymentOptions ใหม่
ตัวเลือกสถานที่จอดรถ parkingOptions ใหม่
รายการปลายทางย่อยที่เกี่ยวข้องกับสถานที่ subDestinations ใหม่
ข้อมูลล่าสุดเกี่ยวกับตัวเลือกเชื้อเพลิงในปั๊มน้ำมัน fuelOptions ใหม่
ข้อมูลการชาร์จ EV ของสถานที่ evChargeOptions ใหม่
แอตทริบิวต์สถานที่ outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports ใหม่

การเปลี่ยนแปลงการตอบกลับการค้นหาข้อความ

ตารางต่อไปนี้แสดงการเปลี่ยนแปลงในช่องระดับบนสุดของออบเจ็กต์คำตอบสําหรับการค้นหาข้อความที่มีอยู่ และออบเจ็กต์คำตอบสําหรับการค้นหาข้อความ (ใหม่) สําหรับ API ใหม่ ช่องระดับบนสุดเพียงช่องเดียวในการตอบกลับคือการ์ด places

ช่อง การค้นหาข้อความ (ที่มีอยู่) การค้นหาข้อความ (ใหม่) หมายเหตุ
การแสดงที่มาของสถานที่ html_attributions ย้ายไปยังออบเจ็กต์ Place ใหม่สำหรับสถานที่แต่ละแห่งเป็น place.attributions
อาร์เรย์สถานที่ results อาร์เรย์ของออบเจ็กต์ Place ที่มีอยู่ places อาร์เรย์ของออบเจ็กต์ Place ใหม่
สถานะของคำขอ status เปลี่ยนไปใช้การตอบกลับ HTTP มาตรฐาน (โค้ดและข้อความการตอบกลับ HTTP)
ข้อความแสดงข้อผิดพลาดที่ปรากฏ error_message ย้ายไปยังการตอบกลับ HTTP มาตรฐาน (โค้ดตอบกลับ HTTP และข้อความ)
ข้อความแสดงข้อมูลต่างๆ info_messages นำออกแล้ว
โทเค็นหน้า next_page_token นำออกแล้ว

การเปลี่ยนแปลงการตอบกลับการค้นหาในบริเวณใกล้เคียง

ตารางต่อไปนี้แสดงการเปลี่ยนแปลงในช่องระดับบนสุดของออบเจ็กต์การตอบกลับสำหรับ Search ในพื้นที่ที่มีอยู่และออบเจ็กต์การตอบกลับสำหรับ Search ในพื้นที่ (ใหม่) สำหรับ API ใหม่ จะมีฟิลด์ระดับบนสุดเพียงฟิลด์เดียวใน การตอบกลับคืออาร์เรย์ places

ช่อง การค้นหาใกล้เคียง (ที่มีอยู่) การค้นหาในบริเวณใกล้เคียง (ใหม่) หมายเหตุ
การแสดงที่มาของสถานที่ html_attributions ย้ายไปยังออบเจ็กต์ Place ใหม่สำหรับสถานที่แต่ละแห่งเป็น place.attributions
อาร์เรย์ของสถานที่ results อาร์เรย์ของออบเจ็กต์ Place ที่มีอยู่ places อาร์เรย์ของออบเจ็กต์ Place ใหม่
สถานะของคำขอ status เปลี่ยนไปใช้การตอบกลับ HTTP มาตรฐาน (โค้ดและข้อความการตอบกลับ HTTP)
ข้อความแสดงข้อผิดพลาดที่ปรากฏ error_message ย้ายไปยังการตอบกลับ HTTP มาตรฐาน (โค้ดตอบกลับ HTTP และข้อความ)
ข้อความแสดงข้อมูลต่างๆ info_messages นำออกแล้ว
โทเค็นหน้า next_page_token นำออกแล้ว

การเปลี่ยนแปลงคำตอบเรื่องรายละเอียดสถานที่

ตารางต่อไปนี้แสดงการเปลี่ยนแปลงในช่องระดับบนสุดของออบเจ็กต์คำตอบสำหรับรายละเอียดสถานที่ที่มีอยู่และออบเจ็กต์คำตอบสำหรับรายละเอียดสถานที่ (ใหม่) สําหรับ API ใหม่ ช่องระดับบนสุดเพียงช่องเดียวในการตอบกลับคืออาร์เรย์ places

ช่อง รายละเอียดสถานที่ (ที่มีอยู่) รายละเอียดสถานที่ (ใหม่) หมายเหตุ
ระบุแหล่งที่มา html_attributions ย้ายไปยังสถานที่ใหม่ ออบเจ็กต์ในฐานะ attributions
รายละเอียดสถานที่ result ที่มีออบเจ็กต์ Place ที่มีอยู่ ออบเจ็กต์สถานที่ใหม่
สถานะของคำขอ status เปลี่ยนไปใช้การตอบกลับ HTTP มาตรฐาน (โค้ดและข้อความการตอบกลับ HTTP)
ข้อความแสดงข้อมูลต่างๆ info_messages เปลี่ยนไปใช้การตอบกลับ HTTP มาตรฐาน (โค้ดและข้อความการตอบกลับ HTTP)