Places API (ใหม่) ประกอบด้วย API ต่อไปนี้:
- รายละเอียดสถานที่ (ใหม่)
- รูปภาพสถานที่ (ใหม่)
- การค้นหาในบริเวณใกล้เคียง (ใหม่)
- การค้นหาข้อความ (ใหม่)
- เติมข้อความอัตโนมัติ (ใหม่)
เอกสารนี้มีภาพรวมของ API ใหม่เหล่านี้
รายละเอียดสถานที่ (ใหม่)
รหัสสถานที่จะระบุสถานที่ในฐานข้อมูล Google Places และใน Google Maps โดยไม่ซ้ำกัน การใช้รหัสสถานที่จะทำให้คุณสามารถขอรายละเอียด สถานประกอบการหรือจุดที่น่าสนใจโดยเริ่มต้นรายละเอียดสถานที่ (ใหม่) อีกครั้ง คำขอรายละเอียดสถานที่ (ใหม่) ส่งคืนข้อมูลที่ครอบคลุมเกี่ยวกับ สถานที่ที่ระบุ เช่น ที่อยู่ที่ครบถ้วน หมายเลขโทรศัพท์ การให้คะแนนของผู้ใช้ และ รีวิว
การรับรหัสสถานที่ทำได้หลายวิธี ดังนี้
- การค้นหาข้อความ (ใหม่)
- การค้นหาในบริเวณใกล้เคียง (ใหม่)
- Geocoding API
- Routes API
- API การตรวจสอบที่อยู่
- เติมข้อความอัตโนมัติเกี่ยวกับสถานที่
รูปภาพสถานที่ (ใหม่)
Place Photo (ใหม่) API ช่วยให้คุณเพิ่มเนื้อหาถ่ายภาพคุณภาพสูงได้ แอปพลิเคชันของคุณได้ โดยให้คุณเข้าถึงรูปภาพนับล้าน ภาพที่จัดเก็บไว้ใน ฐานข้อมูล Google Places เมื่อใช้ Place Photo (New) API คุณจะเข้าถึงรูปภาพและปรับขนาดรูปภาพให้เหมาะสมกับแอปพลิเคชันของคุณได้
คำขอทั้งหมดที่ส่งไปยัง Place Photo (New) API ต้องมีชื่อทรัพยากรรูปภาพ ซึ่งจะระบุรูปภาพที่จะแสดงผล คุณสามารถรับแหล่งข้อมูลรูปภาพ โดยใช้:
หากต้องการรวมชื่อแหล่งข้อมูลของรูปภาพในการตอบกลับจากรายละเอียดสถานที่ (ใหม่)
คำขอการค้นหาข้อความ (ใหม่) หรือการค้นหาใกล้เคียง (ใหม่) ตรวจสอบให้แน่ใจว่าคุณใส่
ฟิลด์ photos ในมาสก์ของช่องของคำขอ
การค้นหาข้อความ (ใหม่) และการค้นหาในบริเวณใกล้เคียง (ใหม่)
Places API มี Search API 2 รายการ ได้แก่
-
ให้คุณระบุสตริงข้อความที่จะใช้ค้นหาสถานที่ ดังตัวอย่างต่อไปนี้ "อาหารมังสวิรัติสไปซี่ในซิดนีย์ ออสเตรเลีย" หรือ "ร้านอาหารทะเลชั้นดีใกล้ Palo Alto, CA"
คุณปรับแต่งการค้นหาได้โดยระบุรายละเอียด เช่น ระดับราคา สถานะการเปิดให้บริการในปัจจุบัน คะแนน หรือสถานที่บางประเภท นอกจากนี้คุณยัง ระบุเพื่อให้ผลลัพธ์มีการให้น้ำหนักกับตำแหน่งที่ตั้งเฉพาะ หรือจำกัดการค้นหา ไปยังสถานที่หนึ่งๆ
การค้นหาในบริเวณใกล้เคียง (ใหม่)
ให้คุณระบุภูมิภาคที่จะค้นหาพร้อมกับรายการประเภทสถานที่ ระบุภูมิภาคเป็นวงกลมที่กําหนดโดยพิกัดละติจูดและลองจิจูดของจุดศูนย์กลางและรัศมีเป็นเมตร
ระบุประเภทสถานที่อย่างน้อย 1 ประเภทที่กําหนดลักษณะของสถานที่ เช่น ระบุ "
pizza_restaurant" และ "shopping_mall" ถึง ค้นหาร้านพิซซ่าในห้างสรรพสินค้าในที่ระบุ ภูมิภาค
ความแตกต่างหลักระหว่างการค้นหาทั้ง 2 ประเภทคือ การค้นหาข้อความ (ใหม่) ให้คุณระบุสตริงการค้นหาแบบกำหนดเองได้ ขณะที่การค้นหาในพื้นที่ใกล้เคียง (ใหม่) กำหนดให้ต้องระบุพื้นที่ที่ต้องการค้นหา
เติมข้อความอัตโนมัติ (ใหม่) และโทเค็นของเซสชัน
การเติมข้อความอัตโนมัติ (ใหม่) เป็นเว็บเซอร์วิสที่แสดงการคาดคะเนสถานที่และการคาดคะเนข้อความค้นหาเพื่อตอบสนองต่อคําขอ HTTP ระบุข้อความในคำขอ สตริงการค้นหาและขอบเขตทางภูมิศาสตร์ที่ควบคุมพื้นที่ที่ค้นหา
โทเค็นเซสชันคือสตริงที่ผู้ใช้สร้างขึ้นซึ่งติดตามการเรียกใช้ฟีเจอร์เติมข้อความอัตโนมัติ (ใหม่) เป็นเซสชัน การเติมข้อความอัตโนมัติ (ใหม่) ใช้โทเค็นของเซสชันเพื่อจัดกลุ่มการค้นหาและ ของการค้นหาในการเติมข้อความอัตโนมัติของผู้ใช้เป็นเซสชันที่แยกจากกันสำหรับ วัตถุประสงค์ในการเรียกเก็บเงิน
ช่องใหม่ แอตทริบิวต์ และตัวเลือกการช่วยเหลือพิเศษ
Places API (ใหม่) มีช่อง แอตทริบิวต์ และตัวเลือกการช่วยเหลือพิเศษใหม่เพื่อให้ผู้ใช้ได้รับข้อมูลเพิ่มเติมเกี่ยวกับสถานที่ ข้อมูลด้านเหล่านี้จะอธิบายไว้ในส่วนต่อไปนี้
ช่อง
Places API (ใหม่) มีฟิลด์ใหม่หลายฟิลด์:
| ช่อง | คำอธิบาย |
|---|---|
regularSecondaryOpeningHours |
อธิบายเวลาของการดำเนินการบางอย่าง ข้อมูลรอง เวลาทำการแตกต่างจากเวลาทำการหลักของธุรกิจ สำหรับ เช่น ร้านอาหารสามารถระบุช่วงเวลาขับรถหรือบริการจัดส่ง เป็นเวลาทำการรองด้วย |
paymentOptions |
ตัวเลือกการชำระเงินที่สถานที่รับ สถานที่สามารถยอมรับได้มากกว่า
หนึ่งตัวเลือกการชำระเงิน หากไม่มีข้อมูลตัวเลือกการชำระเงิน
ระบบจะยกเลิกการตั้งค่าฟิลด์ตัวเลือกการชำระเงิน ตัวเลือกมีดังนี้
|
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 ใหม่ โปรดดูเอกสารประกอบการย้ายข้อมูลต่อไปนี้