ภาพรวม

เลือกแพลตฟอร์ม: Android iOS JavaScript บริการเว็บ
Places API เป็นบริการที่ยอมรับคําขอ HTTP สําหรับข้อมูลตําแหน่งผ่านวิธีการที่หลากหลาย โดยจะแสดงผลข้อมูลสถานที่ที่มีการจัดรูปแบบ และภาพเกี่ยวกับสถานประกอบการ สถานที่ตั้งทางภูมิศาสตร์ หรือจุดสนใจ

ทําไมต้องใช้ Places API

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

  • แสดงคอนโดให้เช่าภายในเขตเมืองใหญ่ที่มีผลการค้นหาเจาะจงเมือง
  • รวมรายละเอียดสถานที่ในการอัปเดตสถานะการรับสินค้าหรือการจัดส่ง
  • แสดงรายการของสวนสาธารณะในพื้นที่พร้อมกับภาพถ่ายและความเห็นที่ผู้ใช้ส่ง
  • แสดงข้อมูลติดต่อ รีวิว และระดับของสถานประกอบการสําหรับสถานที่ต่างๆ ระหว่างที่วางแผนการเดินทาง

Places API ทําอะไรได้บ้าง

คุณสามารถใช้ Places API เพื่อใส่คุณลักษณะต่อไปนี้ในแอปพลิเคชันของคุณ:

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

Places API ทํางานอย่างไร

Places API จะยอมรับคําขอเป็น URL มาตรฐานซึ่งมีปลายทางบริการเฉพาะ เช่น /place หรือ /photo ปลายทางยังยอมรับประเภทของรูปแบบที่ระบุในคําขอด้วย ไม่ว่าจะเป็น JSON หรือ XML และสุดท้าย คําขอบริการใช้พารามิเตอร์ที่เกี่ยวข้องกับปลายทางนั้นๆ เพื่อปรับแต่งข้อมูลที่ส่งกลับ ตัวอย่างเช่น คําขอรายละเอียดสถานที่ต่อไปนี้สําหรับคอมโพเนนต์ที่อยู่จะทํางานดังต่อไปนี้ โดยสมมติว่าการคืนสินค้าอยู่ในรูปแบบ JSON

https://maps.googleapis.com/maps/api/place/details/json
  ?place_id=ChIJrTLr-GyuEmsRBfy61i59si0
  &fields=address_components
  &key=YOUR_API_KEY

ในกรณีนี้ บริการจะใช้รหัสสถานที่ที่ให้มาเพื่อค้นหาสถานที่ที่ขอและส่งคืนคอมโพเนนต์ที่อยู่ในรูปแบบ JSON

แหล่งข้อมูล

ตารางต่อไปนี้สรุปทรัพยากรที่มีผ่าน API ของ Places พร้อมกับข้อมูลที่แสดงผล

แหล่งข้อมูล ข้อมูลที่แสดง รูปแบบการคืนสินค้า
ค้นหาสถานที่ ส่งกลับรายการสถ านที่ที่อิงตามตําแหน่งของอุปกรณ์หรือสตริงค้นหา

ดูรายละเอียดเกี่ยวกับการตอบกลับการค้นหาสถานที่ คําตอบการค้นหาใกล้เคียง และคําตอบจากการค้นหาข้อความ

  • JSON
  • XML
รายละเอียดสถานที่ ส่งคืนข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับสถานที่ที่เฉพาะเจาะจง รวมถึงรีวิวของผู้ใช้

ดูรายละเอียดในคําตอบรายละเอียดสถานที่

  • JSON
  • XML
รูปภาพสถานที่ ให้สิทธิ์เข้าถึงรูปภาพหลายล้านรูปที่เกี่ยวข้องกับสถานที่ที่จัดเก็บไว้ในฐานข้อมูลสถานที่ของ Google

ดูรายละเอียดการตอบรูปภาพ

  • JSON
  • XML
เติมข้อความอัตโนมัติในสถานที่ กรอกชื่อและ/หรือที่อยู่ของสถานที่โดยอัตโนมัติขณะผู้ใช้พิมพ์

ดูรายละเอียดในการวางคําตอบที่เติมข้อความอัตโนมัติ

  • JSON
  • XML
เติมข้อความค้นหาอัตโนมัติ ให้บริการคาดคะเนคําค้นหาสําหรับการค้นหาทางภูมิศาสตร์แบบข้อความ และแสดงผลคําค้นหาที่แนะนําขณะที่ผู้ใช้พิมพ์

ดูรายละเอียดสําหรับคําค้นหาที่เติมข้อความอัตโนมัติ

  • JSON
  • XML

วิธีใช้ Places API

ขั้นตอนด้านล่างครอบคลุมสถานการณ์กรณีการใช้งานทั่วไปสําหรับการใช้ปลายทาง 3 จุดในบริการ Places API เมื่อสร้างโซลูชัน คุณสามารถใช้ ปลายทางเพิ่มเติม เช่น การค้นหาใกล้เคียง รูปภาพสถานที่ และการเติมข้อความค้นหาอัตโนมัติ
1 รับการตั้งค่า เริ่มต้นด้วยการตั้งค่า โปรเจ็กต์ Google Cloud และทําตามวิธีการติดตั้งให้เสร็จสมบูรณ์ จากนั้นเรียนรู้วิธีใช้คีย์ API
2 ลองใช้การค้นหาข้อความเบื้องต้น เมื่อมีคีย์ API แล้ว ให้ทําการค้นหาข้อความธรรมดาตามที่อธิบายไว้ในตัวอย่างการค้นหาข้อความพื้นฐานในคู่มือการค้นหาข้อความ
3 ใช้คําขอหาสถานที่ คําขอสถานที่จะแสดงรหัสสถานที่ พร้อมด้วยช่องข้อมูลที่คุณขอ เช่น เวลาทําการ ที่อยู่ และรูปภาพ ดูตัวอย่างสถานที่ และลองใช้ตัวอย่างที่เกี่ยวข้องมากขึ้นกับกรณีการใช้งานของคุณ
4 ทําความเข้าใจพื้นฐานคําตอบเกี่ยวกับสถานที่ สํารวจข้อมูลที่ได้จากการตอบกลับ "ค้นหาสถานที่" ดูคําตอบเกี่ยวกับสถานที่สําหรับรายละเอียดเพิ่มเติม
5 ใช้รหัสสถานที่เพื่อดูรายละเอียดเพิ่มเติม การค้นหาคําตอบสถานที่ไม่ได้ให้ข้อมูลทั้งหมดของสถานที่นั้นๆ คุณใช้รหัสสถานที่ที่แสดงผลจากการตอบกลับการค้นหาสถานที่เพื่อดูรายละเอียดเพิ่มเติมเกี่ยวกับสถานที่ได้ ดูรายละเอียดสถานที่

ไลบรารีของไคลเอ็นต์ที่ใช้ได้

เรียก API นี้ในภาษาที่คุณต้องการผ่านไลบรารีของไคลเอ็นต์ต่อไปนี้

ไคลเอ็นต์ Java, ไคลเอ็นต์ Python, Go Client และ Node.js สําหรับ Google Maps คือไลบรารีไคลเอ็นต์ที่ได้รับการสนับสนุนจากชุมชน ซึ่งเปิดให้ใช้ภายใต้ใบอนุญาต Apache 2.0 ดาวน์โหลดได้จาก GitHub ซึ่งคุณสามารถอ่านคําแนะนําในการติดตั้งและโค้ดตัวอย่าง

ขั้นตอนถัดไป