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