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

Places API (ใหม่) ประกอบด้วย API ต่อไปนี้:

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

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

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

การรับรหัสสถานที่ทำได้หลายวิธี ดังนี้

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

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

ย้ายข้อมูลไปยัง Places API ใหม่

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