Usage Limiting

Polygon and Polyline Limiting

Timeline API:

  • Polygon - 400 square km and no more than 70km per segment.
  • Polyline - 70 km long.
  • Max number of vertices - 550.

Historical API:

  • Polygon - 10,000 square km and no more than 70km per segment.
  • Polyline - 2,000 km long.
  • Max number of vertices - 550.

Rate Limiting

According to your plan, you are limited to a certain amount of requests per hour and day to any of the API endpoints. You can check the returned HTTP headers to see get your current rate limit status.

When surpassing your rate-limiting you will get a response with a 429 error code.

Headers

Description

X-RateLimit-Limit-second
X-RateLimit-Limit-day
X-RateLimit-Limit-hour

The maximum number of requests that the API key is permitted to make per second/day/hour.

X-RateLimit-Remaining-second
X-RateLimit-Remaining-day
X-RateLimit-Remaining-hour

The number of requests remaining in the current rate limit window.

*If you need a higher rate limit, please reach out to [email protected].