ภาพรวม

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

เหตุผลที่ควรใช้ Places API

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

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

คุณใช้ Places API ทำอะไรได้บ้าง

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

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

Google Maps Platform API จำนวนมากรองรับรหัสสถานที่ ซึ่งรหัสสถานที่จะระบุสถานที่ในฐานข้อมูลของ Google Places และใน Google Maps ได้อย่างไม่ซ้ำกัน การรับรหัสสถานที่มีหลายวิธี ซึ่งรวมถึงจาก Places API แต่จาก Geocoding API, Routes API และ Address Validation API

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

เลือกเวอร์ชัน Places API ของคุณ

Places API รองรับ API 2 เวอร์ชัน ได้แก่ Places API คือ API ที่มีอยู่ และ Places API (ใหม่) คือ API รุ่นใหม่

เมื่อเปิดตัว Places API (ใหม่) สิ่งแรกที่คุณต้องทำคือการตัดสินใจว่าจะใช้ API ชุดใด กรณีนี้จะเกิดขึ้นหากคุณเป็นลูกค้าใหม่หรือลูกค้าเดิมที่ใช้ API นี้อยู่แล้ว ใช้คู่มือนี้เพื่อเรียนรู้ความแตกต่างที่สำคัญระหว่าง API ทั้งสอง

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

Places API (ใหม่)

Places API (ใหม่) จะยอมรับคำขอเป็น URL มาตรฐานที่มีปลายทางบริการที่เฉพาะเจาะจง เช่น /places หรือ places:searchText และแสดงผลการตอบกลับ JSON Places API (ใหม่) รองรับการให้สิทธิ์ด้วยคีย์ API และโทเค็น OAuth ตัวอย่างต่อไปนี้สร้างคำขอรายละเอียดสถานที่เพื่อแสดงผลคอมโพเนนต์ที่อยู่ของรหัสสถานที่โดยใช้คีย์ API

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

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

แหล่งข้อมูล

ตารางต่อไปนี้สรุปแหล่งข้อมูลที่มีให้บริการผ่าน Places API

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

วิธีใช้ Places API

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