Get all parking spots

Provides a list of car2go parking spots for a specific location like ulm or austin in KML format. KML is a file format used to display geographic data in an Earth browser such as Google Earth, Google Maps, and Google Maps for mobile. More information about KML can be found here: KML Reference at code.google.com

The parking spots are especially dedicated for car2go vehicles.

Access:	public
URL:	http://www.car2go.com/api/v2.1/parkingspots
Method:	GET

Parameters

Name	Mandatory	Description
loc	true	location identifier string of the location the parking spots are searched for, e.g. "ulm", "austin".
oauth_consumer_key	true	your assigned oauth consumer key
format	false	defines response format. Value "json" => JSON format, otherwise xml format is used
callback	false	defines JSONP (JSON with Padding) callback function used as wrapper
test	false	has currently no effect

Request Examples

 GET http://www.car2go.com/api/v2.1/parkingspots?loc=Ulm&oauth_consumer_key=consumerkey

 GET http://www.car2go.com/api/v2.1/parkingspots?loc=Austin&oauth_consumer_key=consumerkey&format=json

Response

The KML file defines a placemark tag for each car2go parking spot. The placemark tag defines following sub tags:

name - The name of the parking spot

description - contains the total and used capacity of the parking spot

point - the coordinates of the parking spot

extendeddata - contains the usedCapacity and the totalCapacity of the parking spot as well as if the parking spot has a chargingPole.

Response Examples

A KML response example:

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <kml xmlns:ns3="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0" xmlns:ns2="http://www.w3.org/2005/Atom"
 	xmlns="http://www.opengis.net/kml/2.2">
 	<Document>
 		<description>CAR2GO Parking Lots</description>
 		<Style id="car2go">
 			<IconStyle>
 				<Icon>
 					<href>http://www.car2go.com/common/images/openapi/marker_parking.png
 					</href>
 				</Icon>
 				<hotSpot y="0.0" x="0.0" />
 			</IconStyle>
 		</Style>
 		<Style id="car2go_cp">
 			<IconStyle>
 				<Icon>
 					<href>http://www.car2go.com/common/images/openapi/marker_parking_cp.png
 					</href>
 				</Icon>
 				<hotSpot y="0.0" x="0.0" />
 			</IconStyle>
 		</Style>
 		<Placemark>
 			<name>Inner City Parkspot 2</name>
 			<description>Capacity (used/total): 0/3</description>
 			<styleUrl>#car2go</styleUrl>
 			<ExtendedData>
 				<Data name="usedCapacity"><value>0</value></Data>
 				<Data name="totalCapacity"><value>3</value></Data>
 				<Data name="chargingPole"><value>true</value></Data>
 			</ExtendedData>
 			<Point>
 				<coordinates>9.983611,48.398565,0</coordinates>
 			</Point>
 		</Placemark>
 	</Document>
 </kml>

A JSON response example:

  {"placemarks":[{"coordinates":[-97.750983,30.269577,0],"name":"West Ave","totalCapacity":4,"usedCapacity":0,"chargingPole":false},{"coordinates":[-97.74225,30.265976,0],"name":"100 East 4th Street","totalCapacity":4,"usedCapacity":0,"chargingPole":true}]}

► Sign in to add a comment