= OGR Google Maps Engine API driver =

[[TOC]]

This project aims to implement an OGR driver for the [https://developers.google.com/maps-engine/ Google Maps Engine API] (GME API), to access the GME API vector table data as a vector file format.
I'm also developing this driver as part of my course work for [https://noppa.aalto.fi/noppa/kurssi/maa-123.3550/esite GIS Application Development course (Maa-123.3550 )] at Aalto University.

== API Overview ==
The GME API gives access to data stored in GME. In addition to vector data you can also store imager and KML files in GME. We'll deal with those later in this project (maybe).

The HTTP requests are of the form:

{{{
 GET /tables/{tableId}/features
}}}

The API itself is a RESTfull API with a simple URL scheme. The data is delivered as GeoJSON, so the driver will use libjson from the GeoJSON driver. It will also use the OAuth2 code from the Google Fusion Tables Driver.

== Using the GME Driver ==

This section will contain the most recent options for the driver.

{{{
 "GME:tables='<tableId>' [select='<column1,column2,column3,gx_id,geometry>']"
}}}

== Testing ==

I'll make a few GME tables available for testing purposes. I'm planning to use the [http://grass.osgeo.org/download/sample-data/ GRASS GIS North Carolina data].

== Schedule ==

Backlog will be added soon!
This work will be done in sprints of 3 weeks as follows.

||'''24.9.2013'''|| ||
||Sprint 0 w1|| ||
||Sprint 0 w2||setup and planning||
||Sprint 0 w3||implement get features from table||
||'''15.10.2013'''|| ||
||Sprint 1 w1||support the [https://developers.google.com/maps-engine/documentation/read#select GME API select statement]||
||Sprint 1 w2||Throttling and OAuth2 retry; support for multiple tables||
||Sprint 1 w3||support the [https://developers.google.com/maps-engine/documentation/read#where GME API where statement]||
||'''05.11.2013'''|| ||
||Sprint 2 w1||Rewrite select and where in a GDAL way ||
||Sprint 2 w2||Implement create table support ||
||Sprint 2 w3||Implement update table support ||
||'''26.11.2013'''|| ||
||Sprint 3 w1|| ||
||Sprint 3 w2|| ||
||'''10.12.2013'''|| ||
||Sprint 4 w1|| ||
||Sprint 4 w2|| ||
||Sprint 4 w3|| ||
||'''21.01.2014'''|| ||
||Sprint 5 w1|| ||
||Sprint 5 w2|| ||
||Sprint 5 w3|| ||
||'''11.02.2014'''|| ||
||Sprint 6 w1|| ||
||Sprint 6 w2|| ||
||Sprint 6 w3|| ||
||'''04.03.2014'''|| ||
||Sprint 7 w1|| ||
||Sprint 7 w2|| ||
||Sprint 7 w3|| ||
||'''25.03.2014'''|| ||
||Sprint 8 w1|| ||
||Sprint 8 w2|| ||
||Sprint 8 w3|| ||
||'''15.04.2014'''|| ||