ลิงก์กับ 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
รูปภาพ ลิงก์เพื่อแสดงรูปภาพของสถานที่ใน Google Maps googleMapsLinks.photosUri

ลิงก์ในการตอบกลับของ Places จะอยู่ในช่อง 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 ทางด้านขวาของหน้า

  2. หรือจะขยายแสดงพารามิเตอร์มาตรฐาน แล้วตั้งค่าพารามิเตอร์ fields เป็นมาสก์ฟิลด์ก็ได้

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

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

  5. ในแผงโปรแกรมสำรวจ API ให้เลือก

    เต็มหน้าจอเพื่อขยายหน้าต่างโปรแกรมสำรวจ API