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

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

บทนำ

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

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

การเปลี่ยนแปลงออบเจ็กต์ Place ในการตอบกลับ

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

ออบเจ็กต์การตอบกลับใหม่ใช้การเขียนแบบ Camel Case สำหรับชื่อฟิลด์ มีฟิลด์ใหม่ และเปลี่ยนชื่อฟิลด์เดิมบางรายการ

ช่อง ออบเจ็กต์ Places API (เดิม) ออบเจ็กต์ Places API (ใหม่) หมายเหตุ
ส่วนประกอบของที่อยู่ 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 เปลี่ยนไปในออบเจ็กต์ใหม่ 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 trường trong biểu mẫu 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 นำออกแล้ว

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

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