Snippets

OICP 2.1 Pull EVSE Data | XML

Updated by Julius Poessnecker

File (0) OICP Added

  • Ignore whitespace
  • Hide word diff
+The service description can be found in the OICP 2.1 (EMP).
+
+Section:
+3.4.1 eRoamingPullEVSEData
+
+To download the latest OICP Version, please visit our website:
+https://www.hubject.com/downloads/
Updated by Julius Poessnecker

File (2) Pull EVSE Data | XML.xml Modified

  • Ignore whitespace
  • Hide word diff
 <soapenv:Envelope xmlns:soapenv     = "http://schemas.xmlsoap.org/soap/envelope/"
-                  xmlns:EVSEData    = "http://www.hubject.com/b2b/services/evsedata/v2.0"
+                  xmlns:EVSEData    = "http://www.hubject.com/b2b/services/evsedata/v2.1"
                   xmlns:CommonTypes = "http://www.hubject.com/b2b/services/commontypes/v2.0">
 
    <soapenv:Header/>
Created by Gregor Schermuly

File (1) Description.txt Added

  • Ignore whitespace
  • Hide word diff
+The eRoamingPullEvseData request allows an EMP to download all available EVSE data records of all currently registered CPOs. The EVSE data records will be grouped by their CPO origin and carry an additional timestamp attribute, which indicates the timestamp of the last server-side database operation on this record.
+The result set of PullEvseData requests can be limited by either adding a search center (geo coordinate and radius) or by specifying the timestamp of the last request (mutual exclusive). If a timestamp was given, all EVSE data records will include an additional deltaType attribute having one of the following values:
+•	update The EVSE data record was updated since the given timestamp.
+•	insert A new EVSE data record since the given timestamp.
+•	delete The EVSE data record was removed since the given timestamp.

File (2) Pull EVSE Data | XML.xml Added

  • Ignore whitespace
  • Hide word diff
+<soapenv:Envelope xmlns:soapenv     = "http://schemas.xmlsoap.org/soap/envelope/"
+                  xmlns:EVSEData    = "http://www.hubject.com/b2b/services/evsedata/v2.0"
+                  xmlns:CommonTypes = "http://www.hubject.com/b2b/services/commontypes/v2.0">
+
+   <soapenv:Header/>
+
+   <soapenv:Body>
+      <EVSEData:eRoamingPullEvseData>
+
+         <EVSEData:ProviderID>DE*GDF</EVSEData:ProviderID>
+
+         <!--You have a CHOICE of the next 2 items at this level-->
+         <!--Optional:-->
+         <EVSEData:SearchCenter>
+
+            <CommonTypes:GeoCoordinates>
+               <!--You have a CHOICE of the next 3 items at this level. All are WGS84.-->
+
+               <CommonTypes:Google>
+                  <!-- latitude longitude: -?1?\d{1,2}\.\d{1,6}\s*\,?\s*-?1?\d{1,2}\.\d{1,6} -->
+                  <CommonTypes:Coordinates>50.931844 11.625214</CommonTypes:Coordinates>
+               </CommonTypes:Google>
+
+               <CommonTypes:DecimalDegree>
+                  <!-- -?1?\d{1,2}\.\d{1,6} -->
+                  <CommonTypes:Longitude>11.625214</CommonTypes:Longitude>
+                  <CommonTypes:Latitude >50.931844</CommonTypes:Latitude>
+               </CommonTypes:DecimalDegree>
+
+               <CommonTypes:DegreeMinuteSeconds>
+                  <!-- -?1?\d{1,2}°[ ]?\d{1,2}'[ ]?\d{1,2}\.\d+'' -->
+                  <CommonTypes:Longitude>11° 37' 30.7704''</CommonTypes:Longitude>
+                  <CommonTypes:Latitude >50° 55' 54.6384''</CommonTypes:Latitude>
+               </CommonTypes:DegreeMinuteSeconds>
+
+            </CommonTypes:GeoCoordinates>
+
+            <!-- km ####.# is defined, but only #### seems to be accepted -->
+            <CommonTypes:Radius>100</CommonTypes:Radius>
+
+         </EVSEData:SearchCenter>
+
+         <!--Optional:-->
+         <EVSEData:LastCall>?</EVSEData:LastCall>
+
+         <EVSEData:GeoCoordinatesResponseFormat>Google|
+                                                DegreeMinuteSeconds|
+                                                DecimalDegree</EVSEData:GeoCoordinatesResponseFormat>
+
+      </EVSEData:eRoamingPullEvseData>
+   </soapenv:Body>
+
+</soapenv:Envelope>

File (3) Expected Response.xml Added

  • Ignore whitespace
  • Hide word diff
+<soapenv:Envelope xmlns:soapenv     = "http://schemas.xmlsoap.org/soap/envelope/"
+                  xmlns:EVSEData    = "http://www.hubject.com/b2b/services/evsedata/v2.0"
+                  xmlns:CommonTypes = "http://www.hubject.com/b2b/services/commontypes/v2.0">
+
+   <soapenv:Header/>
+
+   <soapenv:Body>
+      <EVSEData:eRoamingEvseData>
+
+         <EVSEData:EvseData>
+            <!--Zero or more repetitions:-->
+            <EVSEData:OperatorEvseData>
+
+               <EVSEData:OperatorID>?</EVSEData:OperatorID>
+
+               <!--Optional:-->
+               <EVSEData:OperatorName>?</EVSEData:OperatorName>
+
+               <!--Zero or more repetitions:-->
+               <EVSEData:EvseDataRecord deltaType="update|insert|delete" lastUpdate="?">
+                  [...]
+               </EVSEData:EvseDataRecord>
+
+            </EVSEData:OperatorEvseData>
+         </EVSEData:EvseData>
+
+         <!--Optional:-->
+         <EVSEData:StatusCode>
+
+            <CommonTypes:Code>?</CommonTypes:Code>
+
+            <!--Optional:-->
+            <CommonTypes:Description>?</CommonTypes:Description>
+
+            <!--Optional:-->
+            <CommonTypes:AdditionalInfo>?</CommonTypes:AdditionalInfo>
+
+         </EVSEData:StatusCode>
+
+      </EVSEData:eRoamingEvseData>
+   </soapenv:Body>
+
+</soapenv:Envelope>
HTTPS SSH

You can clone a snippet to your computer for local editing. Learn more.