CoPilotMgr - Configs and Stops (CPIK Libraries)

// Print out information about a CopilotVersion.
try {
    CopilotVersion currVersion = CopilotMgr.getVersionInfo();
    System.out.println("Application version: " + currVersion.getAppVersion());
    System.out.println("Map data version: " + currVersion.getDataVersion());
    System.out.println("Map data year: " + String.valueOf(currVersion.getDataYear()));
    System.out.println("Map data quarter: " + String.valueOf(currVersion.getDataQuarter()));
} catch(CopilotException e) {
    System.out.println("Exception! : " + e.toString());
}

String getAppVersion()

// Print out CopilotVersion application version.
try {
  CopilotVersion currVersion = CopilotMgr.getVersionInfo();
  System.out.println("Application version: " + currVersion.getAppVersion());
} catch (CopilotException e) {
  System.out.println("Exception! : " + e.toString());
}

String getDataVersion()

try {
  CopilotVersion currVersion = CopilotMgr.getVersionInfo();
  System.out.println("Application version: " + currVersion.getDataVersion());
} catch (CopilotException e) {
  System.out.println("Exception! : " + e.toString());
}

int getDataYear()

// Print out CopilotVersion map data year.
try {
  CopilotVersion currVersion = CopilotMgr.getVersionInfo();
  System.out.println("Map data year: " + String.valueOf(currVersion.getDataYear()));
}catch(CopilotException e){
  System.out.println("Exception! : " + e.toString());
}

Int getDataQuarter()

// Print out CopilotVersion map data year.
try {
  CopilotVersion currVersion = CopilotMgr.getVersionInfo();
  System.out.println("Map data quarter: " + String.valueOf(currVersion.getDataQuarter()));
}catch(CopilotException e){
  System.out.println("Exception! : " + e.toString());
}

try {
  ConfigurationSetting settingToSet = ConfigurationSetting.*create*(ConfigurationSetting.FLOW_TRAFFIC_AVAILABILITY, ConfigurationSetting.FLOW_TRAFFIC_ENABLED);
  CopilotMgr.setConfigurationSetting(settingToSet);
  System.out.println("ConfigurationSetting is completed.");
} catch (ConfigurationSetting.ConfigurationException configCreationException) {
  System.out.println("Exception thrown while creating configuration: " + configCreationException.toString());
}

try {
  ConfigurationSetting configSetting = CopilotMgr.getConfigurationSetting(ConfigurationSetting.FLOW_TRAFFIC_AVAILABILITY);
  if (configSetting.getBooleanValue())
    System.out.println("Flow traffic is enabled");
  else
    System.out.println("Flow traffic is not enabled");
} catch (ConfigurationSetting.ConfigurationException configCreationException) {
  System.out.println("Exception thrown while getting configuration: " + configCreationException.toString());
}

// Set a truck that is 30' long, 8' wide, 12' high, and 26,500 lbs
TruckDimensions dim = new TruckDimensions(360, 96, 144, 26500, 2);

// Set a truck that is 53' long, 8.5' wide, 13.5' tall, and 80,000 lbs
TruckDimensions dim = new TruckDimensions(636, 102, 162, 80000, 5);

try { // Create a Boolean configuration
  ConfigurationSetting boolConfig = ConfigurationSetting.create( ConfigurationSetting.FLOW_TRAFFIC_AVAILABILITY, ConfigurationSetting.FLOW_TRAFFIC_ENABLED);
  // Create an Integer configuration
  ConfigurationSetting intConfig = ConfigurationSetting.create( ConfigurationSetting.CHEVRON_DISPLAY, ConfigurationSetting.CHEVRON_DISPLAY_LAT_LON);
  // Create a String configuration
  ConfigurationSetting stringConfig = ConfigurationSetting.create( ConfigurationSetting.DRIVER_ID, "TestID");
  // Get the boolean value of a configuration
  System.out.println("Bool value for config: " + String.valueOf(boolConfig.getBooleanValue()));
  // Get the int value of a configuration
  System.out.println("Int value for config: " + String.valueOf(intConfig.getIntegerValue()));
  // Get the String value of a configuration
  System.out.println("String value for config: " + String.valueOf(stringConfig.getStringValue()));
} catch (ConfigurationSetting.ConfigurationException configCreationException) {
  System.out.println("Exception thrown while creating configuration: " + configCreationException.toString());
}

try {
  RouteMgr.removeAllStops();
} catch (CopilotException e) {
  e.printStackTrace();
}

ConfigurationSetting config = null;
try {
  config = ConfigurationSetting.create(ConfigurationSetting.EXTERNAL_TRIP_ID, "CPIK_StartingTrip");
} catch (ConfigurationSetting.ConfigurationException e) {
  e.printStackTrace();
}
CopilotMgr.setConfigurationSetting(config);


// Integrating a new trip with no trip preview
StopList stopList = new StopList();
RouteEnums.AddStopPurpose purpose = RouteEnums.AddStopPurpose.NEW_TRIP;
RouteEnums.RoutePreviewMode prevMode = RouteEnums.RoutePreviewMode.NO_PREVIEW;

Stop stop0;
StopBuilder stopbuilder0 = StopBuilder.fromLatLon(new Coordinate(40.361329, -74.59957));
stopbuilder0.setName("Trimble Maps");

Stop stop1;
StopBuilder stopBuilder1 = StopBuilder.fromLatLon(new Coordinate(40.435886, -74.507074));
stopBuilder1.setName("Costco Wholesale #1174");

Stop stop2;
StopBuilder stopBuilder2 = StopBuilder.fromLatLon(new Coordinate(40.556923, -74.263196));
stopBuilder2.setName("Grover Cleveland Service Plaza, I-95 North");

Stop stop3;
StopBuilder stopBuilder3 = StopBuilder.fromLatLon(new Coordinate(40.729399, -74.007169));
stopBuilder3.setName("395 Hudson Street, New York NY");

try {
  stop0 = stopbuilder0.geocode(GeocodeSearchType.BEST_MATCH).get(0);
  stop1 = stopBuilder1.geocode(GeocodeSearchType.BEST_MATCH).get(0);
  stop2 = stopBuilder2.geocode(GeocodeSearchType.BEST_MATCH).get(0);
  stop3 = stopBuilder3.geocode(GeocodeSearchType.BEST_MATCH).get(0);

  stopList.add(stop0);
  stopList.add(stop1);
  stopList.add(stop2);
  stopList.add(stop3);

} catch (GeocodingException e) {
  e.printStackTrace();
}

try {
  RouteMgr.addStops(purpose, stopList, prevMode);
} catch (RouteException e) {
  e.printStackTrace();
} catch (CopilotException e) {
  e.printStackTrace();
}

Boolean useTabletLayout

private CopilotStartupParams mStartupParams = new CopilotStartupParams() {
    @Override
    // This returns true when app is running on large screen device
    protected boolean useTabletLayout() {
        boolean xlarge = ((getApplicationContext().getResources().getConfiguration().screenLayout & Configuration.SCREENLAYOUT_SIZE_MASK) == Configuration.SCREENLAYOUT_SIZE_XLARGE);

        boolean large = ((getApplicationContext().getResources().getConfiguration().screenLayout & Configuration.SCREENLAYOUT_SIZE_MASK) == Configuration.SCREENLAYOUT_SIZE_LARGE);

        return (xlarge || large);
    }
}

int getDPI()

private CopilotStartupParams mStartupParams = new CopilotStartupParams() {
    @Override
    // Returns the DPI value to use
    protected int getDPI() {
        // This would be the default DPI value CoPilot would use
        int defaultValueForDevice = super.getDPI();
        // Optionally, a multiplier can be applied here, or a custom value can be returned on a per device model basis.
        double multiplier = 1.0;
        return (int)(defaultValueForDevice * multiplier);
    }
}

//StopBuilder to add stops
{
  try {
    double latitude = 40.367709;
    double longitude = -74.655784;
    // Construct a stop from coordinates
    StopBuilder latLonStop = StopBuilder.fromLatLon(new Coordinate(latitude, longitude))
      .setName("Trimble Maps");
    Stop sampleStopA = latLonStop.geocode(GeocodeSearchType.BEST_MATCH).get(0);

    // Construct a stop from city and state
    StopBuilder cityState = StopBuilder.fromCityAndState("Princeton", "NJ")
      .setName("Princeton NJ Stop");
    Stop sampleStopC = cityState.geocode(GeocodeSearchType.BEST_MATCH).get(0);

    // Construct a stop from country and postal code
    StopBuilder countryPostalCode = StopBuilder.fromCountryAndPostalCode("United States", "08540")
      .setName("Princeton NJ");
    StopList sampleStopList = countryPostalCode.geocode(GeocodeSearchType.MULTI_MATCH);

    //add the created stops
    RouteMgr.addStop(RouteEnums.AddStopPurpose.NEW_CURRENT_DESTINATION,
      sampleStopA, false);
    RouteMgr.addStop(RouteEnums.AddStopPurpose.AFTER_FINAL_DESTINATION,
      sampleStopC, false);

    // adding the stops list
    RouteMgr.addStops(RouteEnums.AddStopPurpose.NEW_TRIP,
      sampleStopList, false);

  } catch (CopilotException \| RouteException \| GeocodingException e) {
    System.out.println("Exception! : " + e.toString());
  }
}

// StopBuilder with v10.9 enhanced fields

StopBuilder latLonStop = StopBuilder.fromLatLon(new Coordinate(40.368420, -74.655036));
ArrivalTimeWindowInfo startWindow = new ArrivalTimeWindowInfo(22, 5, 2018, 780);
ArrivalTimeWindowInfo endWindow = new ArrivalTimeWindowInfo(22, 5, 2018, 840);
latLonStop.setEarliestArrivalTime(startWindow);
latLonStop.setLatestArrivalTime(endWindow);
latLonStop.setPlannedDurationMinutes(12);
latLonStop.setSideOfStreetAdherence(StopSideAdherenceLevel.MODERATE);
latLonStop.setID("This is ID");
latLonStop.setNote("This is note");
HashMap<String,String> customFields = new HashMap<String,String>();
customFields.put("CUSTOMCHEVRONDISPLAY", "This is custom chevron message");
latLonStop.setCustomFields(customFields);
latLonStop.setIcon("myStopIcon");
try {
  Stop sampleStopA = latLonStop.setName("Trimble Maps").geocode(GeocodeSearchType.BEST_MATCH).get(0);
} catch (GeocodingException e)
{
  e.printStackTrace();
}

stop.isVehicleRestricted();

If (stop.isVehicleRestricted())
{
StringBuilder result = new StringBuilder();
result.append(“Vehicle restricted: “ + String.valueOf(stop.isVehicleRestricted());
}

 StopBuilder latLonStop = StopBuilder.fromLatLon(new Coordinate(40.368420, -74.655036));
ArrivalTimeWindowInfo startWindow = new ArrivalTimeWindowInfo(22, 5, 2018, 780);
ArrivalTimeWindowInfo endWindow = new ArrivalTimeWindowInfo(22, 5, 2018, 840);
latLonStop.setEarliestArrivalTime(startWindow);
latLonStop.setLatestArrivalTime(endWindow);
stopBuilder.deliveryWindowEnd = endWindow;

Contact contactA = new ContactBuilder()
  .setName("Contact A")
  .setStreetAddress("41 Rumbridge St")
  .setCity("Southampton")
  .setCountry("GB")
  .build();