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

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

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

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

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

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

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

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

คำขอทั้งหมดที่ส่งไปยัง Place Photos (ใหม่) 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 ข้อมูลล่าสุดเกี่ยวกับตัวเลือกเชื้อเพลิงที่มีให้บริการที่ปั๊มน้ำมัน ข้อมูลนี้มีการอัปเดตเป็นประจำ ตัวเลือกมีดังนี้
  • ดีเซล
  • เบนซินธรรมดา
  • เบนซินระดับกลาง
  • Premium
  • 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 สถานที่มีที่นั่งที่รองรับเก้าอี้รถเข็น

ข้อมูลสรุปที่ทำงานด้วยระบบ AI

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

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

ฟีเจอร์ที่ทำงานด้วยระบบ AI ที่เพิ่มลงใน Places API (ใหม่)

รายละเอียดสถานที่ (ใหม่), การค้นหาข้อความ (ใหม่) และการค้นหาในพื้นที่ (ใหม่) รองรับสรุปที่ทำงานด้วยระบบ AI ข้อมูลสรุปที่ทำงานด้วยระบบ AI ต่อไปนี้มีอยู่ในคำตอบของ Places API (ใหม่)

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

Google จะสร้างข้อมูลสรุปเหล่านี้ขึ้นใหม่เป็นประจำเพื่อให้ข้อมูลสรุปเป็นข้อมูลล่าสุด เมื่อส่งคำขอ Places API (ใหม่) คุณจะแสดงข้อมูลล่าสุดในแอป

ย้ายข้อมูลไปยัง Places API เวอร์ชันใหม่

หากคุณเป็นลูกค้าปัจจุบันของ Places API (ใหม่) และต้องการเปลี่ยนแอปไปใช้ API ใหม่ โปรดดูเอกสารประกอบเกี่ยวกับการย้ายข้อมูลต่อไปนี้