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

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

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

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

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

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

ช่อง ออบเจ็กต์สถานที่ที่มีอยู่ ออบเจ็กต์สถานที่ใหม่ หมายเหตุ
คอมโพเนนต์ที่อยู่ address_components addressComponents
วางที่อยู่ไมโครฟอร์แมต 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 ที่มีอยู่ ออบเจ็กต์ Place ใหม่
สถานะของคําขอ status เปลี่ยนไปใช้การตอบกลับ HTTP มาตรฐาน (โค้ดและข้อความการตอบกลับ HTTP)
ข้อความแจ้งข้อมูล info_messages เปลี่ยนไปใช้การตอบกลับ HTTP มาตรฐาน (โค้ดและข้อความการตอบกลับ HTTP)