ลิงก์กับ 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 Explorer ให้เลือก fullscreen

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