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

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

บทนำ

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

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

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

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

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

ช่อง ออบเจ็กต์ Places API (เดิม) ออบเจ็กต์ Places API (ใหม่) หมายเหตุ
ส่วนประกอบของที่อยู่ 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 มีการเปลี่ยนแปลงในออบเจ็กต์ 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)