ภาพรวม

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

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

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

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

สิ่งที่คุณทําได้ด้วย Places API (ใหม่)

คุณสามารถใช้ Places API (ใหม่) เพื่อรวมฟีเจอร์ต่อไปนี้ไว้ในแอปพลิเคชันได้

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

API ของ Google Maps Platform หลายรายการรองรับรหัสสถานที่ ซึ่งรหัสสถานที่จะระบุสถานที่ในฐานข้อมูล Google Places และใน Google Maps โดยไม่ซ้ำกัน คุณรับรหัสสถานที่ได้หลายวิธี เช่น จาก Places API (ใหม่) รวมถึงจาก Geocoding API, Routes API และ Address Validation 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 ขณะสร้างโซลูชัน คุณสามารถใช้ปลายทางเพิ่มเติมได้ เช่น การค้นหาใกล้เคียง (ใหม่) และ Place Photos (ใหม่)
1 ตั้งค่า เริ่มต้นด้วยตั้งค่าโปรเจ็กต์ Google Cloud แล้วทําตามวิธีการตั้งค่าที่ระบุไว้ จากนั้นดูวิธีใช้คีย์ API
2 ลองใช้การค้นหาข้อความพื้นฐาน ทำการค้นหาข้อความโดยใช้การค้นหาข้อความ (ใหม่)
3 ใช้รหัสสถานที่เพื่อดูรายละเอียดเพิ่มเติม API ของ Google Maps Platform หลายรายการจะแสดงผลรหัสสถานที่เป็นส่วนหนึ่งของการตอบกลับ ใช้รหัสสถานที่เพื่อรับรายละเอียดสถานที่ (ใหม่)
4 ดูรูปภาพสำหรับสถานที่ รูปภาพสถานที่ (ใหม่) ช่วยให้คุณเข้าถึงรูปภาพหลายล้านรูปที่จัดเก็บไว้ในฐานข้อมูลสถานที่ ใช้รูปภาพสถานที่ (ใหม่) เพื่อเข้าถึงรูปภาพของสถานที่