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

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