GETTING STARTED
Geocoding service
Our geocoding service is a Web Service with a cartographic API. It will help you to search cities, towns, districts, streets and buildings, as well as places like cafes, schools, stores and other locations based on names (forward geocoding) or latitude and longitude coordinates (reverse geocoding). Also, you can receive information on previously located geo-objects by using their identifiers. Such an operation is called 'lookup'.
To help you get familiar with our service's functions, we created GEO LAB. Here you can make various requests to our service and see how data appears on the map. You can access GEO LAB from your dashboard after signing in.
To help you get familiar with our service's functions, we created GEO LAB. Here you can make various requests to our service and see how data appears on the map. You can access GEO LAB from your dashboard after signing in.
User Account
Working with our service starts with creating your user account. To do so, please click the 'Sign In' button in the upper right corner of our website. When you enter the dashboard for the first time, you will be forwarded to a page where you will be asked to enter your login and password. To create a new account, please click the "Create your free account" link, fill in the form, agree to the Terms of Service by checking the checkbox, and click the 'Sign Up' button.
The system will send an activation link to your email. Please follow that link to confirm your email address. Sometimes this may take a few minutes to get delivered, depending on the performance of email servers. If you don't see our email in your inbox, please check your spam box as well, since spam filters may accidentally put it there.
The system will send an activation link to your email. Please follow that link to confirm your email address. Sometimes this may take a few minutes to get delivered, depending on the performance of email servers. If you don't see our email in your inbox, please check your spam box as well, since spam filters may accidentally put it there.
Dashboard
Dashboard lets you manage your account: change your subscription, edit personal information, configure your email notifications, and link and manage your bank cards used to pay for the service. Here you also can see your user statistics and experiment with geocoding in GEO LAB.
API Key
API Key is used to call geocoding functions. To see the whole list of available functions, please refer to the API Reference section. You can find your API Key in the Subscription menu.
Use the 'Reset' button if you need to reset your API Key. A confirmation message will appear, asking you to confirm that you want to reset your key. After you confirm the reset, you will see your new API Key. Please note that your old key will not work after you get the new one, so make sure you change your key in all applications that use geocoding API.
Use the 'Reset' button if you need to reset your API Key. A confirmation message will appear, asking you to confirm that you want to reset your key. After you confirm the reset, you will see your new API Key. Please note that your old key will not work after you get the new one, so make sure you change your key in all applications that use geocoding API.
Changing the Subscription Plan
You can see your subscription details under 'Parameters' in the Subscription section.
Here you can see your current subscription plan and status.
To change your subscription plan, click on the 'Change' link next to your current plan's information. You will be forwarded to the Change Plan page, where you can choose a new subscription plan and confirm your choice by clicking 'Save'. In case you don't have a bank card linked to your account to pay for the service, the system will automatically redirect you to the 'Add Card' page.
Here you can see your current subscription plan and status.
To change your subscription plan, click on the 'Change' link next to your current plan's information. You will be forwarded to the Change Plan page, where you can choose a new subscription plan and confirm your choice by clicking 'Save'. In case you don't have a bank card linked to your account to pay for the service, the system will automatically redirect you to the 'Add Card' page.
Adding a Payment Card
To link a card to your account, go to the Billing menu and open the 'Payment Methods' panel. Now click the 'Add' button. Enter your card details in the form. After saving the changes, $1 will be debited from your card to verify your card information. After verification that amount will be re-deposited to your card.
You can add multiple cards to your account, with only one of them acting as a primary card. When withdrawing a subscription payment, our billing system will try to use your primary card to make the payment. In case the payment fails, the system will attempt to withdraw money from other cards in the order you have them in your cards list, until the payment is successful.
You can add multiple cards to your account, with only one of them acting as a primary card. When withdrawing a subscription payment, our billing system will try to use your primary card to make the payment. In case the payment fails, the system will attempt to withdraw money from other cards in the order you have them in your cards list, until the payment is successful.
Changing User Profile
You can change your profile information by pressing the pencil icon under 'Parameters' panel in your Profile. Don't forget to hit the 'Save' button to save your changes.
Profile Settings
Let's discuss the options in the 'Settings' section of the Profile menu:
- Allow extra calls - this option turns on/off your ability to send overlimit requests that are available in subscription plans with extra calls. If your subscription plan allows for sending such requests, but you don't want to use them, you can turn this option off. It is turned on by default.
- Receive account alerts - when this option is turned on, the system will send you notifications N days prior to subscription payment dates, and if payment attempts are unsuccessful.
- Receive PickPoint announcements – if you don't want to receive news about new features and changes in our service, you can turn off the PickPoint announcements.
Geo Lab
GEO LAB provides you with a testing ground for all kinds of geocoding request scenarios. To choose the request type use the drop-down list:
To run a request, use the 'RUN' button. The results will be shown below in JSON format (by default). The 'MAP VIEW' button will show the results on the map if the resulting data format allows for it.
After you have finished working on your request, you can copy its source code from the 'Code' panel and use it in your application. The source code is available in four languages:
- Name to Point – a forward geocoding request, resulting in a list of geo-objects.
- Name to Polygon – another forward geocoding request, resulting in a set of points, forming a boundary around an identified geo-object.
- Point to Country - a reverse geocoding request that tells you which country the specified point belongs to.
To run a request, use the 'RUN' button. The results will be shown below in JSON format (by default). The 'MAP VIEW' button will show the results on the map if the resulting data format allows for it.
After you have finished working on your request, you can copy its source code from the 'Code' panel and use it in your application. The source code is available in four languages:
- cURL
- Ruby
- JS
- Python