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

นักพัฒนาแอปในเขตเศรษฐกิจยุโรป (EEA)

บทนำ

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

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

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

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

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

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

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

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

หากต้องการรวมชื่อทรัพยากรของรูปภาพไว้ในการตอบกลับจากคำขอ Place Details (ใหม่), Text Search (ใหม่) หรือ Nearby Search (ใหม่) ให้ตรวจสอบว่าคุณได้รวมช่อง photos ไว้ใน Field Mask ของคำขอแล้ว

การค้นหาข้อความ (ใหม่) และการค้นหาในบริเวณใกล้เคียง (ใหม่)

Places API มี 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 ใหม่ โปรดดูเอกสารการย้ายข้อมูลต่อไปนี้