Go to the purchase page and set up your subscription (you need to have an account, sign in or register if you haven't). You have to first choose a webservice. A description of all the webservices are available on the Gisgraphy website and a functionalities matrix can help you choose. The user guide is also a good start. We strongly recommend that you play with the free server(no SLA, no QOS, number of request limited). It can give you an idea of the relevance and how it works.
A subscription specifies : A webservice and a rate per minute limit for a given number of months. You can have as many subscriptions as you want. If you want to use several webservices, you need several subscriptions. You can also subscribe several times to the same webservice, you will have a different API key for each subscription, and each subscription will have its own configuration, counter, current rate,...
The API key is a numeric parameter you have to specify in the URL for each request. It identifies a subscription and allow us to check the rights on it : has your subscription ended? have you reach the rate for the current minute? is the IP authorized?...)
The rate is a limit of the number of requests you can do during a given minute. It allow all users to use the service without disturbing the others and the opposite. that allow us to provide Quality Of Service (QOS). We sized our servers based on the subscriptions. For every request, your current rate for the given minute is compared to the rate allowed. If you exceed the rate, every request over the limit during the current minute, will return an HTTP 500 error. Requests will be process normally when the current rate of your subscription is reset (when a new minute starts).
Check the subscription configuration you've chosen, and click on the confirm button if everything seems correct to you. (if not, go back and modify the subscription). It will get you to PayPal payment. Everything is secured (HTTPS). We currently only accept PayPal payment. Once payment is made, you will get instant access to the webservices you have subscribed to.
You will receive a confirmation mail with a summary of the subscription and all the necessary informations (host,API Key,etc). Those informations are also available on your web administration console. Some samples are provided. You can also see and download your invoices
You can now call the server via an URL and specify the API key for your subscription at each request.
Optionnally you can sign in to your web administration console and configure your subscriptions : restrict the access to a specific IPs, renew a subscription, see how many times you've reached the rate limit, and much more. You can renew a subscription before it ends : the number of month you renew will be added to the end date of your subscription - you never loose the months lefts. An email will be sent periodically to remind you of the subscriptions that will end soon.
Gisgraphy is open sources, and so does the data : Geonames and Openstreetmap datas are totally free.
You can install it locally and run all the services offline. once installed, you have to run the data import. The Gisgraphy importer downloads the raw data from the the Geonames download server for Geonames data, and from the Gisgraphy download server for Openstreetmap and Quattroshapes.
The reasons why data are not directly downloaded from Openstreetmap is because the data are pre-processed. We extract streets, calculate length, middle point, clean up some values, improve names (especially for fleet tracking), and so on. The other reason is because we thought that it is simpler to import CSV, instead of a complicated XML one
. The importer, then, process, and inject the data locally. It builds a structured database and fill the fulltext engine. It can take a long time, depends on the number of countries you import and your server configuration. To save time, you can order a preprocessed data dump : a dump with the data after they have been processed by the importer).
|Geonames and Openstreetmap||260 Go (200 Go for the fulltext engine + 60 GO for Postgres)||50 GO|