Electric Vehicle Charging Station

This repository is now archived and subsequent works will be carried out the in Smart data models repositories. The latest version of this Data Model can be found at https://github.com/smart-data-models/dataModel.Transportation**

Description

A public charging station supplying energy to electrical vehicles. The charge time depends on the maximum power output of the station, the number of vehicles currently charging and the current battery level.

Data Model

A JSON Schema corresponding to this data model can be found here.

  • id : Unique identifier. It shall be a URN in the form urn:ngsi-ld:EVChargingStation:<identifier> where <identifier> shall be a unique ID string.

  • type : Entity type. It must be equal to EVChargingStation.

  • dataProvider : Specifies the URL to information about the provider of this information

    • Attribute type: Property. URL
    • Optional
  • dateCreated : Entity's creation timestamp.

  • dateModified : Last update timestamp of this entity.

  • source : A sequence of characters giving the source of the entity data.

    • Attribute type: Property. Text or URL
    • Optional
  • location : Geolocation of the charging station represented by a GeoJSON (Multi)Polygon or Point.

  • address : Registered charging station site civic address.

  • name : Name given to the charging station.

    • Attribute type: Property. Text.
    • Normative References: https://uri.etsi.org/ngsi-ld/name equivalent to name
    • Mandatory
  • description : Description of this charging station.

    • Attribute type: Property. Text
    • Normative References: https://uri.etsi.org/ngsi-ld/description equivalent to description
    • Optional
  • image : A URL containing a photo of this charging station.

  • capacity : The total number of vehicles which can be charged at the same time. The total number of sockets can be higher.

    • Attribute type: Property. Number
    • Allowed values: Any positive integer number.
    • Mandatory
  • allowedVehicleType : Vehicle type(s) which can be charged.

    • Attribute type: GeoProperty. List of Text
    • Allowed Values: ( bicycle, bus, car, caravan, motorcycle, motorscooter, truck)
    • Mandatory
  • socketType : The type of sockets offered by this station.

    • Attribute type: Property. List of Text
    • Allowed values: (Type2, CHAdeMO, CCS/SAE, Type3, Tesla, J-1772, Wall_Euro, Caravan_Mains_Socket, Dual_J-1772, Dual_CHAdeMO, Mennekes, Dual_Mennekes, Other)
    • Mandatory
  • socketNumber : The total number of sockets offered by this charging station.

    • Attribute type: Property. Number
    • Allowed values: Any positive integer number.
    • Optional
  • availableCapacity : The number of vehicles which currently can be charged.

    • Attribute type: Property. Number
    • Allowed values: A positive integer number, including 0. It must lower or equal than capacity.
    • Metadata:
      • timestamp: Timestamp corresponding to the last attribute value. (observeAt in NGSI-LD)
    • Optional
  • amperage : The total amperage offered by the charging station.

    • Attribute type: Property. Number
    • Allowed values: Any positive number.
    • Default Unit: Ampers (A)
    • Optional
  • voltage : The total voltage offered by the charging station.

    • Attribute type: Property. Number
    • Allowed values: Any positive number.
    • Default Unit: Volts (V)
    • Optional
  • openingHours : Opening hours of the charging station.

  • status : Status of the charging station.

    • Attribute type: Property. List of Text
    • Allowed values:
      • (working, outOfService, withIncidence, full, almostFull, empty, almostEmpty)
      • Or any other application-specific.
    • Metadata:
      • timestamp : Timestamp corresponding to the last attribute value. (observedAt in NGSI-LD)
    • Optional
  • areaServed : Area served by this charging station. Precise semantics can depend on the application or target city. For instance, it can be a neighbourhood, burough or district.

    • Attribute type: Property. Text
    • Optional
  • owner : Charging station's owner.

    • Attribute type: Property. List of Text or List of URIs
    • Optional
  • operator : Charging station's operator.

    • Attribute Type: Property. Text or URL
    • Optional
  • network : The name of the Network, with that the operator cooperates.

    • Attribute Type: Property. Text or URL
    • Optional
  • contactPoint : Charging station contact point.

  • chargeType : Type(s) of charge when using this station.

    • Attribute type: Property. List of Text
    • Allowed values: (flat, annualPayment, monthlyPayment, free, other)
      • Any other application-specific
    • Optional
  • acceptedPaymentMethod : Accepted payment method(s).

Note: JSON Schemas are intended to capture the data type and associated constraints of the different Attributes, regardless their final representation format in NGSI(v2, LD).

Examples

Normalized Example

Normalized NGSI response

{
    "id": "urn:ngsi-ld:EVChargingStation:ValladolI+D_Covaresa",
    "type": "EVChargingStation",
    "socketType": {
        "value": ["Wall_Euro"]
    },
    "capacity": {
        "value": 2
    },
    "name": {
        "value": "Agencia de Innovaci\u00f3n"
    },
    "allowedVehicleType": {
        "value": ["car"]
    },
    "source": {
        "value": "https://openchargemap.org/"
    },
    "location": {
        "type": "geo:json",
        "value": {
            "type": "Point",
            "coordinates": [-4.747901, 41.618265]
        }
    },
    "chargeType": {
        "value": ["free"]
    },
    "address": {
        "type": "PostalAddress",
        "value": {
            "addressLocality": "Valladolid",
            "addressCountry": "Espa\u00f1a",
            "streetAddress": "Paseo de Zorrilla, 191"
        }
    },
    "operator": {
        "value": "Iberdrola"
    },
    "contactPoint": {
        "value": {
            "email": "vehiculoelectrico@ava.es"
        }
    }
}

key-value pairs Example

Sample uses simplified representation for data consumers ?options=keyValues

{
    "id": "urn:ngsi-ld:EVChargingStation:ValladolI+D_Covaresa",
    "type": "EVChargingStation",
    "name": "Agencia de Innovación",
    "location": {
        "coordinates": [-4.747901, 41.618265],
        "type": "Point"
    },
    "capacity": 2,
    "socketType": ["Wall_Euro"],
    "address": {
        "streetAddress": "Paseo de Zorrilla, 191",
        "addressLocality": "Valladolid",
        "addressCountry": "España"
    },
    "contactPoint": {
        "email": "vehiculoelectrico@ava.es"
    },
    "operator": "Iberdrola",
    "allowedVehicleType": ["car"],
    "chargeType": ["free"],
    "source": "https://openchargemap.org/"
}

LD Example

Sample uses the NGSI-LD representation

{
    "id": "urn:ngsi-ld:EVChargingStation:ValladolI+D_Covaresa",
    "type": "EVChargingStation",
    "socketType": {
        "type": "Property",
        "value": ["Wall_Euro"]
    },
    "capacity": {
        "type": "Property",
        "value": 2
    },
    "name": {
        "type": "Property",
        "value": "Agencia de Innovaci\u00f3n"
    },
    "allowedVehicleType": {
        "type": "Property",
        "value": ["car"]
    },
    "source": {
        "type": "Property",
        "value": "https://openchargemap.org/"
    },
    "location": {
        "type": "GeoProperty",
        "value": {
            "type": "Point",
            "coordinates": [-4.747901, 41.618265]
        }
    },
    "chargeType": {
        "type": "Property",
        "value": ["free"]
    },
    "address": {
        "type": "Property",
        "value": {
            "addressLocality": "Valladolid",
            "addressCountry": "Espa\u00f1a",
            "streetAddress": "Paseo de Zorrilla, 191",
            "type": "PostalAddress"
        }
    },
    "operator": {
        "type": "Property",
        "value": "Iberdrola"
    },
    "contactPoint": {
        "type": "Property",
        "value": {
            "email": "vehiculoelectrico@ava.es"
        }
    },
    "@context": [
        "https://schema.lab.fiware.org/ld/context",
        "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld"
    ]
}

Use it with a real service

T.B.D.

Open Issues

See also