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