เกี่ยวกับ API ของ Places ใหม่

Places API ใหม่มี API ต่อไปนี้

เอกสารนี้มีภาพรวมของ API ใหม่เหล่านี้

API รายละเอียดสถานที่

รหัสสถานที่จะระบุสถานที่ในฐานข้อมูลของ Google Places และใน Google Maps โดยไม่ซ้ำกัน ด้วยรหัสสถานที่ คุณจะขอรายละเอียดเกี่ยวกับสถานประกอบการหรือจุดสนใจหนึ่งๆ ได้โดยส่งคำขอรายละเอียดสถานที่ (ใหม่) คำขอรายละเอียดสถานที่ (ใหม่) จะแสดงข้อมูลที่ครอบคลุมเกี่ยวกับสถานที่ที่ระบุ เช่น ที่อยู่ที่สมบูรณ์ หมายเลขโทรศัพท์ การให้คะแนนของผู้ใช้ และรีวิว

การขอรับรหัสสถานที่ทำได้หลายวิธี คุณสามารถใช้สิ่งต่อไปนี้

API รูปภาพสถานที่

Place Photo (ใหม่) API ช่วยให้คุณเพิ่มเนื้อหาภาพถ่ายคุณภาพสูงลงในแอปพลิเคชันของคุณด้วยการให้สิทธิ์เข้าถึงรูปภาพนับล้านที่เก็บอยู่ในฐานข้อมูล Google Places คุณสามารถใช้ Place Photo (ใหม่) API เพื่อเข้าถึงรูปภาพและปรับขนาดรูปภาพให้เป็นขนาดที่เหมาะสมที่สุดสำหรับแอปพลิเคชันของคุณ

คำขอทั้งหมดที่ส่งไปยัง API รูปภาพ (ใหม่) ต้องมีชื่อทรัพยากรรูปภาพ ซึ่งระบุรูปภาพที่ต้องการให้ส่งคืนโดยไม่ซ้ำกัน คุณสามารถดูชื่อทรัพยากรรูปภาพได้โดยใช้

หากต้องการรวมชื่อทรัพยากรรูปภาพในการตอบกลับจากคำขอรายละเอียดสถานที่ (ใหม่) การค้นหาข้อความ (ใหม่) หรือการค้นหาใกล้เคียง (ใหม่) ให้ตรวจสอบว่าได้ใส่ช่อง photos ในช่องมาสก์ของคำขอแล้ว

การค้นหาข้อความและการค้นหาใกล้เคียง

Places API มี API การค้นหา 2 รายการดังนี้

  • การค้นหาข้อความ (ใหม่)

    ให้คุณระบุสตริงข้อความที่จะค้นหาสถานที่ ตัวอย่างเช่น "อาหารมังสวิรัติรสจัดในซิดนีย์ ออสเตรเลีย" หรือ "ร้านอาหารทะเลชั้นเลิศใกล้เมืองแพโลแอลโต รัฐแคลิฟอร์เนีย"

    คุณสามารถปรับแต่งการค้นหาได้โดยการระบุรายละเอียดต่างๆ เช่น ระดับราคา สถานะการเปิดทำการปัจจุบัน คะแนน หรือสถานที่บางประเภทที่ต้องการ นอกจากนี้ คุณยังสามารถระบุให้น้ำหนักพิเศษกับผลลัพธ์ในตำแหน่งที่ต้องการ หรือจำกัดการค้นหาเฉพาะตำแหน่งที่ตั้งที่ต้องการ

  • การค้นหาใกล้เคียง (ใหม่)

    ให้คุณระบุภูมิภาคที่จะค้นหาพร้อมกับรายการประเภทสถานที่ได้ ระบุภูมิภาคเป็นวงกลมที่กำหนดโดยพิกัดละติจูดและลองจิจูดของจุดศูนย์กลางและรัศมีเป็นเมตร

    ระบุประเภทสถานที่ที่ระบุลักษณะของสถานที่อย่างน้อย 1 ประเภท ตัวอย่างเช่น ระบุ "pizza_restaurant" และ "shopping_mall" เพื่อค้นหาร้านพิซซ่าที่ตั้งอยู่ในห้างสรรพสินค้าในภูมิภาคที่ระบุ

ความแตกต่างที่สำคัญระหว่างการค้นหาทั้งสองคือ การค้นหาข้อความ (ใหม่) ช่วยให้คุณสามารถระบุสตริงการค้นหาที่กำหนดเอง ในขณะที่การค้นหาใกล้เคียง (ใหม่) ต้องใช้พื้นที่เฉพาะในการค้นหา

API เติมข้อความอัตโนมัติและโทเค็นของเซสชัน

API เติมข้อความอัตโนมัติ (ใหม่) คือบริการบนเว็บที่แสดงผลการคาดคะเนสถานที่และการคาดคะเนการค้นหาเพื่อตอบสนองต่อคำขอ HTTP ในคำขอ ให้ระบุสตริงการค้นหาข้อความและขอบเขตทางภูมิศาสตร์ที่ควบคุมพื้นที่การค้นหา

โทเค็นเซสชันเป็นสตริงที่ผู้ใช้สร้างขึ้นซึ่งติดตามการเรียกที่เติมข้อความอัตโนมัติ (ใหม่) เป็นเซสชัน การเติมข้อความอัตโนมัติ (ใหม่) ใช้โทเค็นเซสชันเพื่อจัดกลุ่มคำค้นหาและขั้นตอนการเลือกของการค้นหาแบบเติมข้อความอัตโนมัติของผู้ใช้เป็นเซสชันที่แยกจากกันเพื่อวัตถุประสงค์ในการเรียกเก็บเงิน

ช่องใหม่ แอตทริบิวต์ และตัวเลือกการเข้าถึง

Places API (ใหม่) ประกอบด้วยฟิลด์ แอตทริบิวต์ และตัวเลือกการช่วยเหลือพิเศษใหม่ๆ เพื่อให้ข้อมูลเพิ่มเติมเกี่ยวกับสถานที่แก่ผู้ใช้ แง่มุมเหล่านี้มีคำอธิบายอยู่ในส่วนต่อไปนี้

ช่อง

Places API (ใหม่) มีช่องใหม่หลายช่อง ดังนี้

ฟิลด์ คำอธิบาย
regularSecondaryOpeningHours อธิบายเวลาที่เฉพาะเจาะจงของการดำเนินการบางอย่าง เวลาทําการรองต่างจากเวลาทําการหลักของธุรกิจ เช่น ร้านอาหารสามารถระบุเวลาขับรถทรูหรือเวลาจัดส่งเป็นเวลาทำการรอง
paymentOptions ตัวเลือกการชำระเงินที่สถานที่ยอมรับ สถานที่หนึ่งยอมรับตัวเลือกการชำระเงินได้มากกว่า 1 ตัวเลือก หากข้อมูลตัวเลือกการชำระเงินไม่พร้อมใช้งาน ระบบจะยกเลิกการตั้งค่าช่องตัวเลือกการชำระเงิน โดยมีตัวเลือกดังต่อไปนี้
  • บัตรเครดิต
  • บัตรเดบิต
  • รับเฉพาะเงินสด
  • การชำระเงินผ่าน NFC
parkingOptions สถานที่จอดรถมีตัวเลือกที่จอดรถ โดยมีตัวเลือกดังต่อไปนี้
  • ที่จอดรถฟรี
  • ที่จอดรถแบบเสียค่าใช้จ่าย
  • ที่จอดรถริมถนนแบบไม่เสียค่าใช้จ่าย
  • บริการรับจอดรถ
  • โรงจอดรถแบบไม่เสียค่าใช้จ่าย
  • โรงจอดรถแบบเสียค่าใช้จ่าย
subDestinations สถานที่ที่ไม่ซ้ำซึ่งเกี่ยวข้องกับสถานที่หนึ่งๆ เช่น อาคารผู้โดยสารของสนามบินถือเป็นปลายทางย่อยของสนามบิน
fuelOptions ข้อมูลล่าสุดเกี่ยวกับตัวเลือกเชื้อเพลิงที่มีในปั๊มน้ำมัน ข้อมูลนี้ได้รับการอัปเดตอย่างสม่ำเสมอ โดยมีตัวเลือกดังต่อไปนี้
  • ดีเซล
  • ปกติไม่มีผู้มีโอกาสเป็นลูกค้า
  • เบนซินระดับกลาง
  • พรีเมียม
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • LPG
  • E80
  • E85
  • มีเทน
  • ไบโอดีเซล
  • น้ำมันดีเซลสำหรับรถบรรทุก
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 ใหม่ โปรดดูเอกสารประกอบการย้ายข้อมูลต่อไปนี้