Forgot password?
Unexpected error occurred

How to Connect

So you are interested and would like to integrate Geo Service into your application.

Few things you need to know before you go on.

  • The service is protected with an API key. Get yours here.
  • The service is available on the subscription basis, free option available.
  • Everything about your subscription is managed on this site.

Endpoints

Two endpoints are available:

Authentication

Important: You have two keys: Public and Private. Do not use your Private Key where it can be easily accessed by others, such as JavaScript in the browser. Use only Public Key in these situations.

For REST interface, append apikey parameter to the URL 

http://api.geosvc.com/rest/usa/ca/hollywood?apikey=YOURKEY

For SOAP interface, insert your API key into a custom SOAP header 

<soapenv:Header>
    <geos:ApiKey>YOURKEY</geos:ApiKey>
</soapenv:Header>
For more information, see API Key section

Format

REST interface can return data in two formats: XML (default) and JSON. The format is controlled by the HTTP Accept header or by format parameter in the URL. 

Accept: application/xml
Accept: application/json
Alternatively 
http://api.geosvc.com/rest/usa/ca/hollywood?apikey=YOURKEY&format=json

SOAP interface is limited to XML.

Paging

Functions that return lists support paging. For more information, see Paging section