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 formurn:ngsi-ld:EVChargingStation:<identifier>
where<identifier>
shall be a unique ID string. -
type
: Entity type. It must be equal toEVChargingStation
. -
dataProvider
: Specifies the URL to information about the provider of this information- Attribute type: Property. URL
- Optional
-
dateCreated
: Entity's creation timestamp.- Attribute type: Property. DateTime
- Normative References: http://schema.org/DateTime
- Read-Only. Automatically generated.
-
dateModified
: Last update timestamp of this entity.- Attribute type: Property. DateTime
- Normative References: http://schema.org/DateTime
- Read-Only. Automatically generated.
-
source
: A sequence of characters giving the source of the entity data. -
location
: Geolocation of the charging station represented by a GeoJSON (Multi)Polygon or Point.- Attribute type: GeoProperty.
geo:json
. - Normative References: https://tools.ietf.org/html/rfc7946
- Mandatory if
address
is not defined.
- Attribute type: GeoProperty.
-
address
: Registered charging station site civic address.- Normative References: https://schema.org/address
- Mandatory if
location
is not defined.
-
name
: Name given to the charging station. -
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.- Attribute type: Property. image (URL)
- Normative References: https://schema.org/image
- Optional
-
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. -
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.- Normative references: http://schema.org/openingHours
- Optional
-
status
: Status of the charging station. -
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. -
network
: The name of the Network, with that the operator cooperates. -
contactPoint
: Charging station contact point.- Normative references: https://schema.org/contactPoint
- Optional
-
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).- Normative references: https://schema.org/acceptedPaymentMethod
- Optional
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.