Navigazione

Ottieni una sessione di navigazione attiva usando la query navigation. È utile quando vuoi mostrare l’avanzamento attuale di un conducente lungo un percorso.

Query

Per ottenere i dettagli di una sessione di navigazione è necessario il suo id. L’id si ottiene tramite la mutation startNavigation.

Argomenti

id· ID· required

ID of the navigation session to retrieve

Campi

id· ID

ID of the navigation session.

overview· NavigationOverview

Navigation session details overview.

vehicle_status· NavigationVehicleStatus

The status of the navigation session vehicle. The status can be driving, charging or parked.

NavigationVehicleStatus enum values

driving

Vehicle is driving.

charging

Vehicle is charging.

parked

Vehicle is parked.

status· NavigationStatus

The status of a navigation session. The status can be active or finished.

NavigationStatus enum values

active

Navigation session is live and currently tracking.

finished

Navigation session is completed (either manually or automatically 48 hours after the last update).

meta· NavigationMeta

Navigation meta information.

Errori

Le operazioni possono non riuscire. Tieni conto dei seguenti scenari di errore per gestirli correttamente. Ulteriori informazioni sugli errori here.

navigation_invalid_route_status: Cannot start a navigation session for a route with status '$ROUTESTATUS'.
navigation_not_found: No navigation session was found with the provided ID.
operation_not_allowed: You are not allowed to execute this operation. Enable it for the current application in the dashboard or reach out to customer support.
rate_limit_exceeded: Rate limit exceeded.
route_polyline_invalid_decimals: Value for decimals number is not valid. Allowed values are 5 or 6.

Questo contenuto ti è stato utile?

Esempio di query

x-client-id

x-app-id

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360

query {
  navigation(id: "Enter your id here") {
    id
    overview {
      state_of_charge
      last_known_location {
        type
        coordinates
      }
      current_leg
      next_stop {
        arrival_state_of_charge
        arrival_time
        location {
          type
          coordinates
        }
        station {
          station_id
          evse_id
          connector_id
          operator {
            id
          }
        }
        alternative_stations {
          location {
            type
            coordinates
          }
          station_id
          evse_id
          connector_id
          operator {
            id
          }
        }
      }
      legs {
        distance
        durations {
          total
          charging
          driving
          stopover
          ferry
        }
        origin {
          id
          type
          geometry {
            type
            coordinates
          }
          properties {
            name
            station_id
            external_station_id
            temperature
            air_pressure
            solar_irradiance
            occupants
            total_occupant_weight
            total_cargo_weight
          }
        }
        destination {
          id
          type
          geometry {
            type
            coordinates
          }
          properties {
            name
            station_id
            external_station_id
            temperature
            air_pressure
            solar_irradiance
            occupants
            total_occupant_weight
            total_cargo_weight
          }
        }
        range_at_origin
        range_at_destination
        range_after_charge
        type
        station {
          station_id
          evse_id
          connector_id
        }
        sections {
          type
          origin {
            id
            type
            geometry {
              type
              coordinates
            }
            properties {
              occupants
              total_occupant_weight
              total_cargo_weight
            }
          }
          destination {
            id
            type
            geometry {
              type
              coordinates
            }
            properties {
              occupants
              total_occupant_weight
              total_cargo_weight
            }
          }
          tags
          polyline
          duration
        }
        tags
      }
      durations {
        total
        charging
        driving
        stopover
        ferry
      }
      instructions {
        points {
          size
          interval
        }
        sign
        name
        distance
        time
        exit_number
        turn_angle
      }
      live_route_request {
        vehicle {
          id
          battery {
            capacity {
              value
              type
              source
            }
            state_of_charge {
              value
              type
              source
            }
            final_state_of_charge {
              value
              type
              source
            }
            temperature {
              value
              type
            }
            current
            voltage
            power
            is_charging
          }
          charging {
            mode
            minimum_power
            risk_margin
            connectors {
              standard
              maximum_charge_speed {
                value
                type
                source
              }
            }
            adapters {
              standard
              maximum_charge_speed {
                value
                type
                source
              }
            }
            maximum_state_of_charge
          }
          climate
          heat_pump
          cabin {
            is_preconditioned
            desired_temperature {
              value
              type
            }
          }
        }
        origin {
          id
          type
          geometry {
            type
            coordinates
          }
          properties {
            location {
              name
            }
            vehicle {
              occupants
              total_occupant_weight {
                value
                type
                source
              }
              total_cargo_weight {
                value
                type
                source
              }
            }
          }
        }
        destination {
          id
          type
          geometry {
            type
            coordinates
          }
          properties {
            location {
              name
            }
            station {
              station_id
              external_station_id
              stop_duration
            }
          }
        }
        via {
          id
          type
          geometry {
            type
            coordinates
          }
          properties {
            location {
              name
              stop_duration
            }
            vehicle {
              occupants
              total_occupant_weight {
                value
                type
                source
              }
              total_cargo_weight {
                value
                type
                source
              }
            }
            station {
              station_id
              external_station_id
              stop_duration
            }
          }
        }
        operators {
          ranking {
            type
            levels {
              low {
                id
                countries
              }
              medium {
                id
                countries
              }
              high {
                id
                countries
              }
            }
          }
          exclude {
            id
            countries
          }
          avoid {
            id
            countries
          }
        }
        alternative_station_radius {
          value
          type
        }
        avoid
        driving_preferences {
          speed_factor
          maximum_speed {
            value
            type
          }
          style
        }
        station_preferences {
          prefer_highway_charging
        }
      }
      polyline
      telemetry {
        auxiliary_consumption
        battery_current
        battery_temperature
        battery_voltage
        is_charging
        charge_speed
        charge_total
        total_occupant_weight
        total_cargo_weight
        elevation
        heading
        motor_rpm
        occupants
        odometer
        outside_temperature
        is_parked
        power
        state_of_charge
        tire_pressure
        vehicle_speed
        custom
      }
    }
    vehicle_status
    status
    meta {
      created_at
      updated_at
    }
  }
}

Hai bisogno di aiuto? Contatta il supporto.