รูปแบบการตอบกลับสำหรับ API ของ
รายละเอียดสถานที่,
การค้นหาใกล้เคียง
และ
การค้นหาข้อความ
API ใหม่มีการเปลี่ยนแปลงจากรูปแบบของ API ที่มีอยู่ ความแตกต่างหลักอยู่ในรูปแบบของออบเจ็กต์ Place
ที่แสดงผลโดยแต่ละวิธี ตามที่อธิบายไว้ในการเปลี่ยนแปลงออบเจ็กต์สถานที่ของคำตอบ
นอกจากนี้ ช่องระดับบนสุดของออบเจ็กต์การตอบกลับก็มีการเปลี่ยนแปลงสำหรับ API แต่ละรายการด้วย โปรดดูหัวข้อต่อไปนี้
- การเปลี่ยนแปลงการตอบกลับการค้นหาข้อความ
- การเปลี่ยนแปลงการตอบกลับของ Nearby Search
- การเปลี่ยนแปลงการตอบกลับรายละเอียดสถานที่
การเปลี่ยนแปลงออบเจ็กต์สถานที่ของคำตอบ
ตารางนี้แสดงการเปลี่ยนแปลงของออบเจ็กต์ ใหม่ Place
ในคำตอบสำหรับรายละเอียดสถานที่ (ใหม่) การค้นหาใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) เมื่อเทียบกับออบเจ็กต์ Place
ที่มีอยู่
ออบเจ็กต์การตอบกลับใหม่ใช้ตัวหุ้มอูฐสำหรับชื่อช่อง มีช่องใหม่ และเปลี่ยนชื่อช่องที่มีอยู่บางช่อง
ฟิลด์ | ออบเจ็กต์สถานที่ที่มีอยู่ | ออบเจ็กต์สถานที่ใหม่ | Notes |
---|---|---|---|
คอมโพเนนต์ที่อยู่ | 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 |
มีการเปลี่ยนแปลงรูปแบบของ 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
ฟิลด์ | การค้นหาข้อความ (ที่มีอยู่) | การค้นหาข้อความ (ใหม่) | Notes |
---|---|---|---|
การระบุแหล่งที่มาของสถานที่ | html_attributions |
ย้ายไปไว้ในออบเจ็กต์สถานที่ใหม่ของสถานที่แต่ละแห่งเป็น place.attributions แล้ว |
|
อาร์เรย์ของสถานที่ | อาร์เรย์ results ของออบเจ็กต์ Place ที่มีอยู่ |
อาร์เรย์ places ของออบเจ็กต์ Place ใหม่ |
|
สถานะของคำขอ | status |
ย้ายไปยังการตอบกลับ HTTP มาตรฐาน (โค้ดตอบกลับ HTTP และข้อความ) | |
ข้อความแสดงข้อผิดพลาดที่ปรากฏ | error_message |
ย้ายไปยังการตอบกลับ HTTP มาตรฐาน (โค้ดตอบกลับ HTTP และข้อความ) | |
ข้อความแสดงข้อมูลต่างๆ | info_messages |
นำออกแล้ว | |
โทเค็นของหน้า | next_page_token |
นำออกแล้ว |
การเปลี่ยนแปลงการตอบกลับของ Nearby Search
ตารางต่อไปนี้แสดงการเปลี่ยนแปลงฟิลด์ระดับบนสุดของออบเจ็กต์การตอบกลับสำหรับการค้นหา Nearby ที่มีอยู่และออบเจ็กต์การตอบกลับ
สำหรับการค้นหาใกล้เคียง (ใหม่) สำหรับ API ใหม่ ช่องระดับบนสุดเพียงช่องเดียวในการตอบสนองคืออาร์เรย์ places
ฟิลด์ | การค้นหาใกล้เคียง (ที่มีอยู่) | การค้นหาใกล้เคียง (ใหม่) | Notes |
---|---|---|---|
การระบุแหล่งที่มาของสถานที่ | html_attributions |
ย้ายไปไว้ในออบเจ็กต์ Place ใหม่สำหรับแต่ละสถานที่เป็น place.attributions แล้ว |
|
อาร์เรย์ของสถานที่ | อาร์เรย์ results ของออบเจ็กต์ Place ที่มีอยู่ |
อาร์เรย์ places ของออบเจ็กต์ Place ใหม่ |
|
สถานะของคำขอ | status |
ย้ายไปยังการตอบกลับ HTTP มาตรฐาน (โค้ดตอบกลับ HTTP และข้อความ) | |
ข้อความแสดงข้อผิดพลาดที่ปรากฏ | error_message |
ย้ายไปยังการตอบกลับ HTTP มาตรฐาน (โค้ดตอบกลับ HTTP และข้อความ) | |
ข้อความแสดงข้อมูลต่างๆ | info_messages |
นำออกแล้ว | |
โทเค็นของหน้า | next_page_token |
นำออกแล้ว |
การเปลี่ยนแปลงคำตอบเรื่องรายละเอียดสถานที่
ตารางต่อไปนี้แสดงการเปลี่ยนแปลงที่ทำต่อช่องระดับบนสุดของออบเจ็กต์การตอบสนองสำหรับรายละเอียดสถานที่ที่มีอยู่และออบเจ็กต์การตอบสนองสำหรับรายละเอียดสถานที่ (ใหม่) สำหรับ API ใหม่ ช่องระดับบนสุดเพียงช่องเดียวในการตอบสนองคืออาร์เรย์ places
ฟิลด์ | รายละเอียดสถานที่ (ที่มีอยู่) | รายละเอียดสถานที่ (ใหม่) | Notes |
---|---|---|---|
การระบุแหล่งที่มาของสถานที่ | html_attributions |
ย้ายไปไว้ในออบเจ็กต์สถานที่ใหม่ในชื่อ attributions แล้ว |
|
รายละเอียดสถานที่ | result ที่มีออบเจ็กต์ Place ที่มีอยู่ |
ออบเจ็กต์สถานที่ใหม่ | |
สถานะของคำขอ | status |
ย้ายไปยังการตอบกลับ HTTP มาตรฐาน (โค้ดตอบกลับ HTTP และข้อความ) | |
ข้อความแสดงข้อมูลต่างๆ | info_messages |
ย้ายไปยังการตอบกลับ HTTP มาตรฐาน (โค้ดตอบกลับ HTTP และข้อความ) |