Frequently asked questions

What are the differences between the paid and free versions of the Yandex.Maps API?

What services are available in the paid Yandex.Maps API?

How do I know if the free version of the API will work for me or if I need to purchase the paid version?

What operations are charged for in the JavaScript API?

How are requests calculated for the daily use of the service?

I want to buy the paid version of the Yandex.Maps API. What should I do?

How do I specify the key in the code?

I use the same key for different services. Are requests to these services added together or counted separately?

What happens if I exceed the purchased limit?

Where can I view information about pricing plans and overuse charges?

Can I get a test key for the JavaScript API commercial version?

Can I get a test key for the Places API commercial version?

Prices are shown only per year. Is it possible to pay monthly?

Where can I keep track of request statistics? How often are stats updated?

Can I transfer my key to another account? For example, if an employee leaves the company.

I forgot the password to the account that was used for registering the key. What should I do?

Why doesn't the commercial version support Satellite and Hybrid map types? The free version has them.

I use the free Yandex.Maps API, but my site/app is getting more traffic now. How can I track the number of API requests in order to switch to the commercial version in time?

My project doesn't use geocoding, routing or panorama search. How much will a JavaScript API license cost?

Answers

What are the differences between the paid and free versions of the Yandex.Maps API?

The differences are as follows:

  • The commercial version of the Yandex.Maps API doesn't have the limitations of the free version. This means that the commercial version can be used in commercial projects, in applications with limited access, or in monitoring systems.
  • The "Satellite" and "Hybrid" layers are not available in commercial versions of the JavaScript API and Static API. This is because the license restrictions of data providers don't allow using satellite layers in third-party commercial projects.
  • The commercial version doesn't support Internet Explorer 8.

What services are available in the paid Yandex.Maps API?

The Yandex.Maps API includes several services and libraries: For the convenience of counting requests, these services are combined into 4 packages:

  1. JavaScript API and Geocoder HTTP API

  2. Places API

  3. Static API

  4. MapKit SDK

API requests made from different packages are not combined and are charged separately. This means that if you are going to use Geocoder and Places, you will need to choose the pricing plan for each of the packages.

How do I know if the free version of the API will work for me or if I need to purchase the paid version?

Please read the free version's terms of use carefully. If your project doesn't meet one or more conditions (for example, you will use the Yandex.Maps API in your company's internal network), you should buy the commercial version of the API.

What operations are charged for in the JavaScript API?

In the JavaScript API, all operations that include requests to the geocoding, routing and panorama search services are charged a fee. For example, adding a placemark by address (this implies using Geocoder) is charged. Adding a placemark by geographic coordinates isn't charged. More information about how requests are counted.

How are requests calculated for the daily use of the service?

For the JavaScript API and Geocoder and for MapKit, the total number of requests is calculated with the formula:

  • + + 5 × .

For the Places API and Static API, requests are calculated in the standard way:

  • One HTTP request to the service is counted as one request toward the limit.

The daily request limit for each service is determined by the chosen pricing plan. API requests made from different packages are not combined and are charged separately. This means that if you are going to use Geocoder and Places, you will need to choose the pricing plan for each of the packages.

I want to buy the paid version of the Yandex.Maps API. What should I do?

For detailed purchase instructions, see the sections:

How do I specify the key in the code?

  • Link for accessing the JavaScript API:

    https://enterprise.api-maps.yandex.ru/<version number>/?lang=<language ID>&apikey=<API key><additional parameters>
    
  • Link for accessing the Geocoder HTTP API:

    https://geocode-maps.yandex.ru/1.x/?lang=<language ID>&apikey=<API key>&<additional parameters>
    
  • Link for accessing the Places API:

    https://search-maps.yandex.ru/v1/?apikey=<key>&<additional parameters>
    
  • You don't need a key to access the free version of the Static API. Link for accessing the commercial version of the Static API:

    https://enterprise.static-maps.yandex.ru/1.x/?key=<API key>&<additional parameters>
    

I use the same key for different services. Are requests to these services added together or counted separately?

Requests made from different packages are not combined and are charged separately. For example, if you use the same key for accessing Geocoder and the Places API, requests are still counted separately according to the pricing plan you chose for each package.

What happens if I exceed the purchased limit?

At the end of the month, you will get an invoice for exceeding the limits. The cost each 1000 requests over the limit depends on the chosen pricing plan.

Where can I view information about pricing plans and overuse charges?

You can read about pricing plans in the description of services or in the «Finance» section in the Developer's Dashboard.

Can I get a test key for the JavaScript API commercial version?

The commercial version of the JavaScript API includes the same functionality as the free version. To learn more about the API features, use the free version.

Alert

When using the free version of the JavaScript API, you need to consider restrictions.

If you need to test the JavaScript API outside of the restrictions (for example, in closed systems), write to us. In your message, specify which project needs a key and for which period. Also specify the expected number of requests to the geocoding, routing and panorama services. A manager will contact you when your request has been processed.

Can I get a test key for the Places API commercial version?

You can learn about features of the Places API using the free version. To get a key for the free version, go to the Developer's Dashboard and choose «Get key». Fill in the required fields, leaving the «Paid version required» option empty. After you send the request, a key is generated. It is activated automatically on receipt, so you can start using it in your project immediately. To switch to the commercial version of the API in the future, write to us, specifying the received key in the message.

Alert

The free version of the Places API has a limit of 500 requests per day. In addition, you must comply with a number of limitations.

If you need to use a test key in one of the special terms (for example, in a closed system), write to us. In your message, provide a description of your project and for what period you need a test key. Also specify the expected number of API requests. A manager will contact you when your request has been processed.

Prices are shown only per year. Is it possible to pay monthly?

When you purchase a pricing plan, you can only pay per year.

Where can I keep track of request statistics? How often are stats updated?

To view the request statistics:

  1. Go to the Personal account.
  2. Choose the key (in the left menu).
  3. On the right side of the page, enter the day or period you want to get statistics for and click «Show».

The statistics shows both the total number of API requests and the number of requests to individual services (for example, Geocoder, Router, panoramas). Statistics are updated with a one-hour delay.

Can I transfer my key to another account? For example, if an employee leaves the company.

No, you can't transfer your key to a different account. We recommend that you get the keys for a shared corporate account.

I forgot the password to the account that was used for registering the key. What should I do?

Follow the password recovery instructions.

Why doesn't the commercial version support Satellite and Hybrid map types? The free version has them.

API request statistics is available on the Keys page on the Developer's Dashboard.

I use the free Yandex.Maps API, but my site/app is getting more traffic now. How can I track the number of API requests in order to switch to the commercial version in time?

Satellite images are subject to licensing restrictions imposed by data providers. This data cannot be used in third-party commercial products. For this reason, we can't sell this data or access to it. This is why Satellite and Hybrid layers are only available in the free version of the API under the license restrictions.

My project doesn't use geocoding, routing or panorama search. How much will a JavaScript API license cost?

In this case, the license for the JavaScript API will cost 120,000 rubles per year.

I have another question

If you can't find an answer to your question, write us through the feedback form. Attach a screenshot if possible. If your question is related to the JavaScript API, provide the code where the error occurred. To do this, upload the code to JSFiddle and save it by clicking Save in the upper-left corner. Add the resulting link to the description of the problem.

Feedback