ลิงก์กับ 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

ลิงก์ในคำตอบของสถานที่อยู่ในฟิลด์ 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