คํานวณสรุปการกำหนดเส้นทาง

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

  1. ส่งพารามิเตอร์ RoutingParameters ในคำขอโดยใช้ setOrigin() เพื่อระบุพิกัดละติจูดและลองจิจูดของต้นทางการกำหนดเส้นทาง พารามิเตอร์นี้จําเป็นสําหรับคํานวณระยะเวลาและระยะทางไปยังสถานที่แต่ละแห่งในการตอบกลับ

  2. เมื่อสร้างออบเจ็กต์คำขอ ให้เพิ่ม .setRoutingSummariesIncluded(true)

ใช้การค้นหาข้อความ (ใหม่)

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

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

// Define the routing parameters object and pass the routing origin.
RoutingParameters routingParameters = RoutingParameters.builder()
    .setOrigin(toLatLng("-33.8688, 151.1957362"))
    .build();

// Use the builder to create a SearchByTextRequest object and pass the routing parameters.
// Set setRoutingSummariesIncluded to true.
final SearchByTextRequest searchByTextRequest = SearchByTextRequest.builder("Spicy Vegetarian Food in Sydney, Australia", placeFields)
    .setMaxResultCount(10)
    .setRoutingParameters(routingParameters)
    .setRoutingSummariesIncluded(true)
    .build();

// Call PlacesClient.searchByText() to perform the search.
// Define a response handler to process the returned Lists of Place objects, RoutingSummary objects, and Leg objects.
placesClient.searchByText(searchByTextRequest)   
    .addOnSuccessListener(response -> {
      List<Place> places = response.getPlaces();
      List<RoutingSummary> routingSummaries = response.getRoutingSummaries();
      List<Leg> legs = routingSummaries.get(0).getLegs();
      Duration duration = legs.get(0).getDuration();
    });

คลาส SearchByTextResponse จะแสดงการตอบกลับจากคำขอการค้นหา คุณสามารถเรียกใช้ SearchByTextResponse.getRoutingSummaries() เพื่อแสดงรายการสรุปการกำหนดเส้นทาง ออบเจ็กต์ SearchByTextResponse ยังประกอบด้วย

  • รายการออบเจ็กต์ Place ที่แสดงสถานที่ที่ตรงกันทั้งหมด โดยมีออบเจ็กต์ Place 1 รายการต่อสถานที่ที่ตรงกัน
  • ออบเจ็กต์ Place แต่ละรายการจะมีเฉพาะช่องที่กำหนดโดยรายการช่องที่ส่งผ่านในคำขอ

ในตัวอย่างนี้ คุณคำนวณระยะเวลาเดินทางและระยะทางไปยังสถานที่แต่ละแห่งในการตอบกลับของ Search ในพื้นที่ใกล้เคียง ตัวอย่างนี้ค้นหาร้านอาหารในซิดนีย์ ประเทศออสเตรเลีย แล้วตั้งค่าการจำกัดตำแหน่งและต้นทางของการกำหนดเส้นทางให้เป็นพิกัดละติจูดและลองจิจูดเดียวกัน

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

// Define the search area as a 500 meter diameter circle in Sydney, Australia.
LatLng center = new LatLng(-33.8688, 151.1957362);
CircularBounds circle = CircularBounds.newInstance(center, /* radius = */ 500);

// Define the routing parameters object and pass the routing origin.
RoutingParameters routingParameters = RoutingParameters.builder()
    .setOrigin(toLatLng("-33.8688, 151.1957362"))
    .build();

// Use the builder to create a SearchNearbyRequest object and pass the routing parameters.
// Set setRoutingSummariesIncluded to true.
final SearchNearbyRequest searchNearbyRequest =
SearchNearbyRequest.builder(/* location restriction = */ circle, placeFields)
    .setIncludedTypes(includedTypes)
    .setMaxResultCount(10)
    .setRoutingParameters(routingParameters)
    .setRoutingSummariesIncluded(true)
    .build();

// Call PlacesClient.searchNearby() to perform the search.
// Define a response handler to process the returned Lists of Place objects, RoutingSummary objects, and Leg objects.
placesClient.searchNearby(searchNearbyRequest)
    .addOnSuccessListener(response -> {
      List<Place> places = response.getPlaces();
      List<RoutingSummary> routingSummaries = response.getRoutingSummaries();
      List<Leg> legs = routingSummaries.get(0).getLegs();
      Duration duration = legs.get(0).getDuration();
    });

คลาส SearchNearbyResponse แสดงการตอบกลับจากคําขอค้นหา คุณสามารถเรียกใช้ SearchNearbyResponse.getRoutingSummaries() เพื่อแสดงรายการสรุปการกำหนดเส้นทาง ออบเจ็กต์ SearchNearbyResponse ยังมีข้อมูลต่อไปนี้ด้วย

  • รายการออบเจ็กต์ Place ที่แสดงสถานที่ที่ตรงกันทั้งหมด โดยมีออบเจ็กต์ Place 1 รายการต่อสถานที่ที่ตรงกัน
  • ออบเจ็กต์ Place แต่ละรายการจะมีเฉพาะฟิลด์ที่กําหนดโดยรายการฟิลด์ที่ส่งมาในคําขอ

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

ระบุตัวเลือกการเดินทาง

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

ในตัวอย่างถัดไป คุณจะระบุโหมดการเดินทางเป็น DRIVE และหลีกเลี่ยงทางหลวง

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

// Define the routing modifiers object.
RouteModifiers routeModifiers = RouteModifiers.builder()
    .setAvoidHighways(true)
    .build();

// Define the routing parameters object and pass the routing origin.
RoutingParameters routingParameters = RoutingParameters.builder()
    .setOrigin(toLatLng("-33.8688, 151.1957362"))
    .setTravelMode(DRIVE)
    .setRouteModifiers(routeModifiers)
    .build();

// Use the builder to create a SearchByTextRequest object and pass the routing parameters.
// Set setRoutingSummariesIncluded to true.
final SearchByTextRequest searchByTextRequest = SearchByTextRequest.builder("Spicy Vegetarian Food in Sydney, Australia", placeFields)
    .setMaxResultCount(10)
    .setRoutingParameters(routingParameters)
    .setRoutingSummariesIncluded(true)
    .build();

// Call PlacesClient.searchByText() to perform the search.
// Define a response handler to process the returned Lists of Place objects, RoutingSummary objects, and Leg objects.
placesClient.searchByText(searchByTextRequest)   
    .addOnSuccessListener(response -> {
      List<Place> places = response.getPlaces();
      List<RoutingSummary> routingSummaries = result.getRoutingSummaries();
      List<Leg> legs = routingSummaries.get(0).getLegs();
      Duration duration = legs.get(0).getDuration();
    });