ลิงก์กับ Google Maps

Places API ยอมรับคําขอข้อมูลสถานที่ผ่านวิธีการต่างๆ การตอบกลับของ Places API มีข้อมูลเกี่ยวกับสถานที่ ซึ่งรวมถึงข้อมูลตำแหน่งและภาพ ตำแหน่งทางภูมิศาสตร์ และจุดที่น่าสนใจ

การตอบกลับจากการค้นหาข้อความ การค้นหาในพื้นที่ และรายละเอียดสถานที่ในรุ่นนี้จะมีลิงก์ไปยัง Google Maps ด้วย ผู้ใช้สามารถเรียกดูลิงก์ Google Maps เหล่านี้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับสถานที่ในการตอบกลับ

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

นอกจากลิงก์ที่เพิ่มลงในออบเจ็กต์ Place แล้ว เวอร์ชันนี้ยังเพิ่มช่อง googleMapsUri ลงในออบเจ็กต์ Reviews และ Photos ในการตอบกลับด้วย

  • Reviews.googleMapsUri: มีลิงก์ Google Maps ไปยังรีวิวเพื่อให้คุณดูรีวิวในเบราว์เซอร์ได้

  • Photos.googleMapsUri: มีลิงก์ Google Maps ไปยังรูปภาพเพื่อให้คุณดูรูปภาพในเบราว์เซอร์ได้

เครื่องมือสํารวจ API ช่วยให้คุณส่งคําขอที่ใช้งานได้เพื่อให้คุณคุ้นเคยกับตัวเลือกใหม่เหล่านี้

ลองใช้งาน

ตารางต่อไปนี้แสดงลิงก์ Google Maps ที่คุณใส่ไว้ในคำตอบได้

ลิงก์ Google Maps คำอธิบาย ชื่อช่อง
สถานที่ ลิงก์เพื่อเปิด Google Maps ไปยังสถานที่ googleMapsLinks.placeUri
เส้นทาง ลิงก์เพื่อเปิดเส้นทางไปยังสถานที่ใน Google Maps googleMapsLinks.directionsUri
เขียนรีวิว ลิงก์สำหรับเขียนรีวิวสถานที่ใน Google Maps googleMapsLinks.writeAReviewUri
อ่านรีวิว ลิงก์เพื่อแสดงรีวิวของสถานที่ใน Google Maps googleMapsLinks.reviewsUri
Photos ลิงก์เพื่อแสดงรูปภาพของสถานที่ใน Google Maps googleMapsLinks.photosUri

ราคา

ฟีเจอร์นี้อยู่ในช่วงทดลองใช้ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปและไม่มีค่าใช้จ่าย ซึ่งหมายความว่าการเรียกเก็บเงินจะเป็น $0 สำหรับการใช้งานในช่วงทดลองใช้ ดูรายละเอียดเกี่ยวกับราคาที่เสนอได้ที่การใช้งานและการชำระเงินสำหรับ Places API

ลิงก์ในการตอบกลับสถานที่จะอยู่ในช่อง googleMapsLinks อย่าลืมใส่ช่อง googleMapsLinks ไว้ในมาสก์ฟิลด์ของคำขอหากต้องการให้ปรากฏในการตอบกลับ

ตัวอย่างเช่น การค้นหาข้อความต่อไปนี้จะรวมลิงก์ Maps ทั้งหมดในการตอบกลับ

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

คำตอบอยู่ในรูปแบบ

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

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

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

ใส่เส้นทางในการตอบกลับ

เมธอด Places ทั้งหมดรองรับการสร้างลิงก์เส้นทางในการตอบกลับ ระบบจะใช้ตำแหน่งปัจจุบันเป็นจุดต้นทาง ใช้ตำแหน่งของสถานที่เป็นปลายทาง และโหมดการเดินทางคือขับรถ

ตัวอย่างถัดไปใช้การค้นหาในพื้นที่ใกล้เคียงเพื่อใส่ลิงก์เส้นทางใน Maps ในการตอบกลับในช่อง directionsUri

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

เวอร์ชันนี้จะเพิ่มช่อง googleMapsUri ลงในออบเจ็กต์ Reviews และ Photos ในคำตอบ การไปยังลิงก์เหล่านี้จะเป็นการเปิดรีวิวหรือรูปภาพใน Google Maps

ตัวอย่างเช่น การค้นหาข้อความต่อไปนี้มีรีวิวและรูปภาพสำหรับสถานที่แต่ละแห่งในการตอบกลับ

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

ในการตอบกลับ องค์ประกอบแต่ละรายการของอาร์เรย์รีวิวและรูปภาพจะมีช่อง googleMapsUri เพื่อเปิดรีวิวหรือรูปภาพในเบราว์เซอร์

ลองใช้งาน

โปรแกรมสำรวจ API ช่วยให้คุณสร้างคําขอตัวอย่างเพื่อให้คุ้นเคยกับ API และตัวเลือก API

  1. เลือกไอคอน API ขยายโปรแกรมสำรวจ API ทางด้านขวาของหน้า

  2. (ไม่บังคับ) ขยายแสดงพารามิเตอร์มาตรฐานและตั้งค่าพารามิเตอร์ fields เป็นมาสก์ช่อง

  3. แก้ไขเนื้อหาคําขอ (ไม่บังคับ)

  4. เลือกปุ่มดำเนินการ ในกล่องโต้ตอบ ให้เลือกบัญชีที่ต้องการใช้ส่งคำขอ

  5. ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนขยาย ขยายโปรแกรมสำรวจ API เพื่อขยายหน้าต่างโปรแกรมสำรวจ API