ย้ายข้อมูลการตอบกลับของ Places API (เดิม)

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

บทนำ

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

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

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

ตารางนี้แสดงการเปลี่ยนแปลงในออบเจ็กต์ Place ใหม่ในการตอบกลับสำหรับรายละเอียดสถานที่ (ใหม่) การค้นหาในบริเวณใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) เมื่อเทียบกับออบเจ็กต์ 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 ในแบบฟอร์ม 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 นำออกแล้ว

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

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