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

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

บทนำ

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

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

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

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

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

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