ลิงก์กับ 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. เลือก fullscreen ในแผงโปรแกรมสำรวจ API

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