geocubes - advanced map search

What is geocubes? Developers Pricing Twitter About us Create Account Sign in
REST Interface
API Reference Home:

 API Reference Home

client access:

 REST Interface
PHP Library

geocubes common:

 Javascript Example
Function Overview


Quick Links:
 Defects / Enhancements List
Manage Account
 		The REST Interface lets you easily add and remove points to geocubes in every programming language you want. You only need to call the Url below from your application and modify the parameters like you want.

Main URL
http://api.geocubes.com/bin/rest
Note that you have to request the REST URL from the IP Address which you added at Manage Account
Parameters
&o=
"add" for adding a point and "remove" for removing a point

&k=
your geocubes api key

&t=
your geocubes api token

&id=
unique id of point

&lt=
latitude value of point

&lg=
longitude value of point

&f1=
optional signed integer field

&f2=
optional signed integer field

&ft=
optional free text field for keywords (url encoded)
example request to add a point:
http://api.geocubes.com/bin/rest?o=add&k=api_key&t=api_token&id=2838240&lt=40.42342&lg=-112.132423
example request to remove a point:
http://api.geocubes.com/bin/rest?o=remove&k=api_key&t=your_api_token&id=2838240
HTTP Response Codes
Description:
The REST Interface returns the "X-GC-Status" Code in the HTTP Header of the Response. The value of "X-GC-Status" is also returned in the normal HTTP Status Code. You can decide which you want to process in your application.

Codes:
X-GC-Status: 200
CREATED: point was successfully added

X-GC-Status: 201
REMOVED: point was successfully removed

X-GC-Status: 401
NO_AUTH: authentication failed
please check if geocubes key and token are correct

X-GC-Status: 404
NOT_FOUND: can't remove point because no point with the given unique id was found

X-GC-Status: 406
NOT_ACCEPTED: request was not accepted
check if all required parameters has a value

X-GC-Status: 409
DUPLICATE: point with the given unique id already exists

X-GC-Status: 500
undefined error
Complete response HTTP Header example:
HTTP/1.1 401 Unauthorized
Transfer-Encoding: chunked
X-GC-Status: 401
Content-type: text/html
Date: Tue, 14 Jul 2009 16:05:03 GMT
Server: lighttpd/1.4.13