Snippets

OICP 2.1 Pull EVSE Data | XML

Created by Gregor Schermuly last modified Julius Poessnecker
1
2
3
4
5
6
7
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/
1
2
3
4
5
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.
<soapenv:Envelope xmlns:soapenv     = "http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:EVSEData    = "http://www.hubject.com/b2b/services/evsedata/v2.1"
                  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>
<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>

Comments (0)

HTTPS SSH

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