Why register or login

Access management interface
Buy Webservices with QOS / SLA
Get premium support
OpenStreetMap data extraction
Order data dump
Consulting
Learn more

Log In


Lost your password ?

Not a member? Sign Up!


Gisgraphy
Premium webservices

Developer guide


[top]


Is there some sample code available ?

Yes - the webservices can output a lot of different formats. Just specify the 'format' parameter (see documentation). If you use PHP, you can evaluate the feed directly (with the eval method of PHP) - same thing in Python. Some sample code are available on the client libraries page In javascript, you have a Javascript library and a leaflet plugin

What are the HTTP status codes returned ?

Here are the HTTP status codes that webservices can return

  • 401 : Need auth. The API key parameter is missing or wrong, or doesn't correspond to any subscriptions
  • 403 : Unhauthorized (auth will change nothing). Your IP is not allowed.
  • 429 : Too many requests. You exceeded the authorized rate
  • 412 : Missing parameter. Some parameters required for the webservices are missing, please consult the documentation
  • Others : standard code (404: page not found, 500 : internal error)

[top]


When I call the webservices, I get 'error null'. What does it means ?

The billing server is probably down. Please contact administrator.

error null

[top]


Is it possible to call the webservice with HTTP instead of HTTPS ?

If you call using HTTP, your request will be automatically redirected to HTTPS.

[top]


What encoding do you use ?

The parameters have to be URL encoded.

[top]


What HTTP method is supported ?

Only GET is allowed. OPTION and HEAD are also accepted, but POST is not.

[top]


What about the same-origin security policy / CORS ?

Same-origin_policy : some browsers or software doesn't allow you to make Ajax calls to a different server than the current page one. If you have some problems, use a kind of proxy on you server, that will make calls and send them back to the browser.
We have some CORS or Cross-origin_resource_sharing but can not give warranty on that.