Places API (ใหม่) มี API ต่อไปนี้
- รายละเอียดสถานที่ (ใหม่)
- Place Photo (ใหม่)
- การค้นหาในบริเวณใกล้เคียง (ใหม่)
- การค้นหาข้อความ (ใหม่)
- เติมข้อความอัตโนมัติ (ใหม่)
เอกสารนี้มีภาพรวมของ API ใหม่เหล่านี้
รายละเอียดสถานที่ (ใหม่)
รหัสสถานที่จะระบุสถานที่ในฐานข้อมูล Google Places และใน Google Maps โดยไม่ซ้ำกัน เมื่อใช้รหัสสถานที่ คุณจะขอรายละเอียดเกี่ยวกับสถานประกอบการหรือจุดที่น่าสนใจที่เฉพาะเจาะจงได้โดยเริ่มคําขอรายละเอียดสถานที่ (ใหม่) คำขอรายละเอียดสถานที่ (ใหม่) จะแสดงข้อมูลที่ครอบคลุมเกี่ยวกับสถานที่ที่ระบุ เช่น ที่อยู่ หมายเลขโทรศัพท์ คะแนนของผู้ใช้ และรีวิว
คุณรับรหัสสถานที่ได้หลายวิธี คุณสามารถใช้สิ่งต่อไปนี้ได้
- การค้นหาข้อความ (ใหม่)
- การค้นหาในบริเวณใกล้เคียง (ใหม่)
- Geocoding API
- Routes API
- Address Validation API
- Place Autocomplete
รูปภาพสถานที่ (ใหม่)
Place Photo (New) API ช่วยให้คุณเพิ่มเนื้อหารูปภาพคุณภาพสูงลงในแอปพลิเคชันได้โดยให้สิทธิ์เข้าถึงรูปภาพหลายล้านรูปที่จัดเก็บไว้ในฐานข้อมูล Google Places เมื่อใช้ Place Photo (New) API คุณจะเข้าถึงรูปภาพและปรับขนาดรูปภาพให้เหมาะสมกับแอปพลิเคชันของคุณได้
คำขอทั้งหมดที่ส่งไปยัง Place Photo (New) API ต้องมีชื่อทรัพยากรรูปภาพ ซึ่งจะระบุรูปภาพที่จะแสดงผล คุณดูชื่อทรัพยากรรูปภาพได้โดยใช้สิ่งต่อไปนี้
หากต้องการใส่ชื่อแหล่งข้อมูลรูปภาพในการตอบกลับจากคำขอรายละเอียดสถานที่ (ใหม่) การค้นหาข้อความ (ใหม่) หรือการค้นหาใกล้เคียง (ใหม่) โปรดตรวจสอบว่าคุณได้ใส่ช่อง photos ไว้ในมาสก์ฟิลด์ของคำขอ
การค้นหาข้อความ (ใหม่) และการค้นหาในบริเวณใกล้เคียง (ใหม่)
Places API มี Search API 2 รายการ ได้แก่
-
ให้คุณระบุสตริงข้อความที่จะใช้ค้นหาสถานที่ เช่น "อาหารมังสวิรัติรสเผ็ดในซิดนีย์ ออสเตรเลีย" หรือ "ร้านอาหารทะเลชั้นเลิศใกล้กับปาโลอัลโต รัฐแคลิฟอร์เนีย"
คุณปรับแต่งการค้นหาได้โดยระบุรายละเอียด เช่น ระดับราคา สถานะการเปิดให้บริการในปัจจุบัน คะแนน หรือสถานที่บางประเภท นอกจากนี้ คุณยังระบุให้ผลการค้นหาเอนเอียงไปยังสถานที่หนึ่งๆ หรือจำกัดการค้นหาให้อยู่ในสถานที่หนึ่งๆ ได้ด้วย
การค้นหาในบริเวณใกล้เคียง (ใหม่)
ให้คุณระบุภูมิภาคที่จะค้นหาพร้อมกับรายการประเภทสถานที่ ระบุภูมิภาคเป็นวงกลมที่กําหนดโดยพิกัดละติจูดและลองจิจูดของจุดศูนย์กลางและรัศมีเป็นเมตร
ระบุประเภทสถานที่อย่างน้อย 1 ประเภทที่กําหนดลักษณะของสถานที่ เช่น ระบุ "
pizza_restaurant" และ "shopping_mall" เพื่อค้นหาร้านอาหารพิซซ่าที่อยู่ในห้างสรรพสินค้าในภูมิภาคที่ระบุ
ความแตกต่างหลักระหว่างการค้นหาทั้ง 2 ประเภทคือ การค้นหาข้อความ (ใหม่) ช่วยให้คุณระบุสตริงการค้นหาแบบกำหนดเองได้ ขณะที่การค้นหาในพื้นที่ใกล้เคียง (ใหม่) กำหนดให้ต้องระบุพื้นที่ที่ต้องการค้นหา
ฟีเจอร์เติมข้อความอัตโนมัติ (ใหม่) และโทเค็นเซสชัน
การเติมข้อความอัตโนมัติ (ใหม่) เป็นเว็บเซอร์วิสที่แสดงการคาดคะเนสถานที่และการคาดคะเนข้อความค้นหาเพื่อตอบสนองต่อคําขอ HTTP ในคำขอ ให้ระบุสตริงข้อความค้นหาและขอบเขตทางภูมิศาสตร์ที่ควบคุมพื้นที่การค้นหา
โทเค็นเซสชันคือสตริงที่ผู้ใช้สร้างขึ้นซึ่งติดตามการเรียกใช้ฟีเจอร์เติมข้อความอัตโนมัติ (ใหม่) เป็นเซสชัน การเติมข้อความอัตโนมัติ (ใหม่) ใช้โทเค็นเซสชันเพื่อจัดกลุ่มระยะการค้นหาและระยะการเลือกของการค้นหาที่เติมข้อความอัตโนมัติของผู้ใช้ไว้ในเซสชันที่แยกกันเพื่อวัตถุประสงค์ในการเรียกเก็บเงิน
ช่อง แอตทริบิวต์ และตัวเลือกการช่วยเหลือพิเศษใหม่
Places API (ใหม่) มีช่อง แอตทริบิวต์ และตัวเลือกการช่วยเหลือพิเศษใหม่เพื่อให้ผู้ใช้ได้รับข้อมูลเพิ่มเติมเกี่ยวกับสถานที่ ข้อมูลด้านเหล่านี้จะอธิบายไว้ในส่วนต่อไปนี้
ช่อง
Places API (ใหม่) มีช่องใหม่หลายช่อง ดังนี้
| ช่อง | คำอธิบาย |
|---|---|
regularSecondaryOpeningHours |
อธิบายเวลาของการดำเนินการบางอย่าง เวลาทําการรองจะแตกต่างจากเวลาทําการหลักของธุรกิจ เช่น ร้านอาหารอาจระบุเวลาทำการของบริการขับรถผ่านหรือเวลาทำการของบริการจัดส่งเป็นเวลาทำการรอง |
paymentOptions |
ตัวเลือกการชำระเงินที่สถานที่ยอมรับ สถานที่หนึ่งๆ ยอมรับตัวเลือกการชำระเงินได้มากกว่า 1 รายการ หากไม่มีข้อมูลตัวเลือกการชำระเงิน ระบบจะไม่ตั้งค่าช่องตัวเลือกการชำระเงิน ตัวเลือกมีดังนี้
|
parkingOptions |
ตัวเลือกที่จอดรถที่สถานที่ให้บริการ ตัวเลือกมีดังนี้
|
subDestinations |
สถานที่ที่ไม่ซ้ำกันซึ่งเกี่ยวข้องกับสถานที่หนึ่งๆ เช่น อาคารผู้โดยสารของสนามบินจะถือเป็นจุดหมายย่อยของสนามบิน |
fuelOptions |
ข้อมูลล่าสุดเกี่ยวกับตัวเลือกเชื้อเพลิงที่มีให้บริการที่ปั๊มน้ำมัน ข้อมูลนี้มีการอัปเดตเป็นประจำ ตัวเลือกมีดังนี้
|
evChargeOptions |
จำนวนที่ชาร์จรถยนต์ไฟฟ้า (EV) ที่สถานีนี้ แม้ว่าที่ชาร์จ EV บางตัวจะมีหัวชาร์จหลายหัว แต่ที่ชาร์จแต่ละตัวจะชาร์จได้ครั้งละ 1 คันเท่านั้น ช่องนี้จึงแสดงจํานวนเครื่องชาร์จ EV ที่พร้อมใช้งาน ณ เวลาหนึ่งๆ |
shortFormattedAddress |
ที่อยู่สั้นๆ ที่มนุษย์อ่านได้สำหรับสถานที่ |
primaryType |
ประเภทหลักของผลการค้นหาหนึ่งๆ เช่น สถานที่อาจจัดอยู่ในประเภท cafe หรือ airport สถานที่มีประเภทหลักได้เพียงประเภทเดียวเท่านั้น โปรดดูรายการค่าที่เป็นไปได้ทั้งหมดที่หัวข้อประเภทที่รองรับ |
primaryTypeDisplayName |
ชื่อที่แสดงของประเภทหลักที่แปลเป็นภาษาของคำขอ หากมี โปรดดูรายการค่าที่เป็นไปได้ทั้งหมดที่หัวข้อประเภทที่รองรับ |
Attributes
Places API (ใหม่) มีแอตทริบิวต์ใหม่หลายรายการ ดังนี้
| แอตทริบิวต์ | คำอธิบาย |
|---|---|
outdoorSeating |
สถานที่นี้มีที่นั่งกลางแจ้ง |
liveMusic |
สถานที่นี้มีดนตรีสด |
menuForChildren |
สถานที่มีเมนูสำหรับเด็ก |
servesCocktails |
สถานที่นี้เสิร์ฟค็อกเทล |
servesDessert |
สถานที่ให้บริการของหวาน |
servesCoffee |
สถานที่ให้บริการกาแฟ |
goodForChildren |
สถานที่เหมาะสำหรับเด็ก |
allowsDogs |
สถานที่อนุญาตให้สุนัขเข้าได้ |
restroom |
สถานที่นี้มีห้องน้ำ |
goodForGroups |
สถานที่รองรับกลุ่ม |
goodForWatchingSports |
สถานที่เหมาะสำหรับการชมกีฬา |
ตัวเลือกการช่วยเหลือพิเศษ
Places API (ใหม่) มีช่องตัวเลือกการช่วยเหลือพิเศษต่อไปนี้
| ช่อง | คำอธิบาย |
|---|---|
wheelchairAccessibleParking |
สถานที่มีที่จอดรถที่รองรับเก้าอี้รถเข็น |
wheelchairAccessibleEntrance |
สถานที่มีทางเข้าสำหรับเก้าอี้รถเข็น |
wheelchairAccessibleRestroom |
สถานที่มีห้องน้ำที่รองรับเก้าอี้รถเข็น |
wheelchairAccessibleSeating |
สถานที่มีที่นั่งที่รองรับเก้าอี้รถเข็น |
ย้ายข้อมูลไปยัง Places API เวอร์ชันใหม่
หากคุณเป็นลูกค้าปัจจุบันของ Places API และต้องการเปลี่ยนแอปไปใช้ API ใหม่ โปรดดูเอกสารประกอบเกี่ยวกับการย้ายข้อมูลต่อไปนี้