Charging Preferences

Control how EVRP selects and optimizes charging stops to match driver preferences and operational requirements.

Charger Network Selection

Specify which charging networks to include:

{
  "preferences": {
    "charger_networks": [
      "tesla_supercharger",
      "electrify_america",
      "chargepoint",
      "evgo"
    ]
  }
}

Charge only enough to reach the next stop or destination:

{
  "preferences": {
    "charging_strategy": "minimum",
    "min_arrival_soc_percent": 15
  }
}

Optimize for total trip time, balancing charging speed and frequency:

{
  "preferences": {
    "charging_strategy": "balanced"
  }
}

Fewer stops with more charging per stop:

{
  "preferences": {
    "charging_strategy": "comfortable",
    "preferred_soc_range": {
      "min": 20,
      "max": 90
    }
  }
}

Set maximum time per charging session:

{
  "preferences": {
    "max_charge_time_minutes": 30,
    "max_total_charging_minutes": 60
  }
}

Filter chargers by available amenities:

{
  "preferences": {
    "amenities": {
      "required": ["restrooms"],
      "preferred": ["food", "wifi", "covered"]
    }
  }
}

Available amenity filters:

Optimize for charging cost:

{
  "preferences": {
    "optimize_for": "cost",
    "max_price_per_kwh": 0.45
  }
}

Configure safety margins:

{
  "preferences": {
    "min_arrival_soc_percent": 20,
    "emergency_buffer_km": 30
  }
}

The emergency_buffer_km ensures there's always enough range to reach an alternative charger if the planned one is unavailable.

Enable real-time charger status checks:

{
  "preferences": {
    "check_availability": true,
    "avoid_if_queue_greater_than": 2
  }
}

When enabled, the API will: