ลิงก์กับ 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 ที่คุณรวมไว้ในการตอบกลับได้

รวมลิงก์ทั้งหมดในการตอบกลับของ Places

ลิงก์ในการตอบกลับของ 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 API ทางด้านขวา ของหน้า

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

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

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

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

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