รวมข้อมูลสรุปเส้นทางเข้ากับ "ค้นหาบนเส้นทาง"

คุณสามารถรวมการคำนวณสรุปเส้นทางเข้ากับการค้นหาตามเส้นทางได้ ในกรณีนี้ การค้นหาข้อความ (ใหม่) จะแสดงระยะเวลาและระยะทางในการเดินทางไปยัง ในการตอบสนอง และจากแต่ละที่ไปยังปลายทางสุดท้ายของ เส้นทาง

เพื่อใช้การค้นหาข้อความ (ใหม่) เพื่อคำนวณสรุปการกำหนดเส้นทางไปพร้อมกับการค้นหา ระหว่างเส้นทาง:

  1. ใช้ Routes API เพื่อคำนวณเส้นทางที่แสดงผลรูปหลายเหลี่ยมของเส้นทางในการตอบกลับ

  2. ใช้พารามิเตอร์ searchAlongRouteParameters.polyline.encodedPolyline เพื่อ ส่งผ่านโพลีไลน์ของเส้นทางไปยังการค้นหาข้อความ (ใหม่) เพื่อให้ผลการค้นหาให้น้ำหนักกับ เส้นทาง จากนั้นการตอบกลับจะมีสถานที่ที่ตรงกับเกณฑ์การค้นหาและอยู่ใกล้กับเส้นทางที่ระบุด้วย

  3. ใส่ routingSummaries ในมาสก์ของช่องเพื่อให้คำตอบรวม อาร์เรย์ routingSummaries อาร์เรย์นี้มีระยะเวลาและระยะทาง ต้นทางการกำหนดเส้นทางไปยังแต่ละจุดในคำตอบ

โดยค่าเริ่มต้น การค้นหาข้อความ (ใหม่) จะทำการค้นหาตลอดเส้นทาง ดังนี้

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food",
  "searchAlongRouteParameters": {
    "polyline": {
      "encodedPolyline": "ROUTE_POLYLINE"
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

การตอบกลับประกอบด้วย 2 อาร์เรย์: อาร์เรย์ places ที่มีการจับคู่ และอาร์เรย์ routingSummaries มีระยะเวลาและระยะทางถึง เดินทางไปสถานที่แต่ละแห่ง

{
  "places": [
    {
      "formattedAddress": "1477 Plymouth St suite c, Mountain View, CA 94043, USA",
      "priceLevel": "PRICE_LEVEL_INEXPENSIVE",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "2464 W El Camino Real C, Mountain View, CA 94040, USA",
      "priceLevel": "PRICE_LEVEL_INEXPENSIVE",
      "displayName": {
        "text": "Veggie Garden",
        "languageCode": "en"
      }
    },
   …
],
  "routingSummaries": [
    {
      "legs": [
        {
          "duration": "285s",
          "distanceMeters": 1616
        },
        {
          "duration": "2466s",
          "distanceMeters": 58147
        }
      ]
    },
    {
      "legs": [
        {
          "duration": "696s",
          "distanceMeters": 4704
        },
        {
          "duration": "2787s",
          "distanceMeters": 58901
        }
      ]
    },
   …
  ]
}

สำหรับการค้นหาข้อความ (ใหม่) แต่ละรายการในอาร์เรย์ legs จะแสดงเวลาเดินทาง 2 ช่วง ดังนี้

  • ขาแรกประกอบด้วยระยะเวลาการเดินทางและระยะทางจากต้นทางถึง สถานที่นั้น ในตัวอย่างนี้ ระยะเวลาและระยะทางจากต้นทางถึง อยู่ในอันดับแรกในผลการค้นหาคือ 285 วินาทีและ 1,616 เมตร

  • ส่วนช่วงที่สองจะมีระยะเวลาเดินทางและระยะทางจากจุดนั้นๆ ไปยังจุดหมายของเส้นทาง ในตัวอย่างนี้ ระยะเวลาและระยะทางคือ 2466 วินาที และ 58147 เมตร

ระบุต้นทางของเส้นทาง โหมดการเดินทาง และตัวปรับเปลี่ยนเส้นทาง

คุณสามารถแก้ไขการคำนวณการค้นหาและการกำหนดเส้นทางโดยสรุปได้โดยระบุ ต้นทางของการกำหนดเส้นทาง โหมดการเดินทาง ตัวปรับเปลี่ยนเส้นทาง และค่ากำหนดการกำหนดเส้นทาง ตัวเลือกโหมดการเดินทางและตัวแก้ไขเส้นทางจะทํางานเหมือนกับการคํานวณสรุปเส้นทางโดยไม่ได้ระบุเส้นทาง ดังที่แสดงในระบุตัวเลือกการเดินทาง

โดยค่าเริ่มต้น ขาแรกของผลลัพธ์แต่ละรายการจะมีระยะห่างจากต้นทาง เส้นประกอบของแต่ละตำแหน่ง อย่างไรก็ตาม คุณสามารถลบล้างค่าเริ่มต้นนั้นได้ ระบุต้นทางของการกำหนดเส้นทางในคำขออย่างชัดแจ้ง หากระบุไว้ ระยะทางแรกของการตอบกลับทั้งหมดจะระบุระยะทางและระยะเวลาจากต้นทางการกำหนดเส้นทางที่ระบุ ซึ่งจะลบล้างต้นทางจากเส้นประกอบ

ในตัวอย่างถัดไป คุณจะระบุจุดเริ่มต้นของเส้นทางเป็นพิกัดของซานมาเทโอ รัฐแคลิฟอร์เนีย ระบุให้หลีกเลี่ยงทางด่วน และตั้งค่าจำนวนผลลัพธ์เป็น 5

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food",
  "maxResultCount": 5,
  "searchAlongRouteParameters": {
    "polyline": {
      "encodedPolyline": "ROUTE_POLYLINE"
    }
  },
  "routingParameters": {
    "origin": {
      "latitude": 37.56617,
      "longitude": -122.30870
    },
    "travelMode":"DRIVE",
    "routeModifiers": {
      "avoidTolls": true
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

รูปภาพต่อไปนี้แสดงแผนที่ที่มีเส้นประกอบของเส้นทาง จุดเริ่มต้นใหม่ (หมุดสีน้ำเงินอ่อน) และสถานที่ในผลการค้นหา (หมุดสีเขียว) โปรดสังเกตว่าผลการค้นหาทั้งหมดอยู่ตามเส้นทางแต่ผ่านซาน มาเทโอ

ผลการค้นหาจากแหล่งที่มาของการอัปเดต