เกี่ยวกับ Places API (ใหม่)

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

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

รายละเอียดสถานที่ (ใหม่)

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

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

รูปภาพสถานที่ (ใหม่)

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 รายการ หากไม่มีข้อมูลตัวเลือกการชำระเงิน ระบบจะไม่ตั้งค่าช่องตัวเลือกการชำระเงิน ตัวเลือกมีดังนี้
  • บัตรเครดิต
  • บัตรเดบิต
  • รับเฉพาะเงินสด
  • การชำระเงินผ่าน 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 ใหม่ โปรดดูเอกสารประกอบเกี่ยวกับการย้ายข้อมูลต่อไปนี้