ForHosting KIT · Developer Utilities

Projectile time at height calculator

This projectile time at height calculator finds the two moments when a launched object reaches a specified elevation above its starting point.

● BetaFree · in your browser
Use it from WebAPIEmailTelegramApp soon

Enter the launch speed, launch angle, target height, and optionally a local gravitational acceleration. The result separates the upward crossing from the downward crossing and also reports the trajectory’s maximum height. If the requested elevation lies above the apex, the calculator returns a clear error instead of producing imaginary or misleading times. It is useful for physics study, trajectory checks, and repeatable engineering calculations.

Enter a consistent projectile scenario

Provide launch speed in meters per second, the angle in degrees above the horizontal, and the target height in meters above the launch point. The height therefore uses the launch position as zero; it is not an altitude above sea level unless the launch itself occurs at sea level. Gravity is measured in meters per second squared and defaults to standard Earth gravity, 9.80665, but you can replace it when a classroom problem specifies another value or when you are modeling a different environment. Keep every quantity in these stated units because the calculator does not silently convert kilometers per hour, feet, radians, or other conventions. The launch angle must be greater than zero and no more than ninety degrees, while speed and gravity must be positive. A zero target height is valid and returns launch time as the first crossing. These definitions make the input unambiguous and keep the two returned times tied to the same physical reference frame. Air resistance, lift, wind, Earth curvature, and changing gravity are outside this ideal projectile model.

Understand how both crossing times are found

The calculation begins by resolving the launch speed into its vertical component using the sine of the launch angle. Vertical position then follows the constant-acceleration equation: height equals vertical speed multiplied by time minus one half of gravity multiplied by time squared. Setting that position equal to your requested height produces a quadratic equation. Its smaller real root is the ascending time, when the projectile first reaches the level while moving upward. Its larger real root is the descending time, when it returns through the same level after the apex. At exactly the maximum height, the roots coincide because the projectile touches that elevation at one instant; both named fields consequently contain the same time. The reported maximum height is computed from the same vertical component and gravity, so it provides a useful check on the request. Results are rounded to a stable precision for reproducible JSON output, while the underlying calculation retains normal floating-point precision. Horizontal speed does not affect when a particular vertical level is crossed in this idealized model.

Interpret unreachable heights and apply the result

A real crossing exists only when the quadratic discriminant is zero or positive. If the target height exceeds the maximum elevation produced by the selected speed, angle, and gravity, the discriminant is negative and the requested times would be complex rather than physical. The calculator treats that condition as invalid input and states the maximum reachable height, allowing you to revise the scenario deliberately. You can increase speed, choose a steeper angle, lower the requested height, or use the gravity specified by your problem. Once valid times are returned, use the ascending value for events on the way up and the descending value for events after the apex, such as timing a sensor, comparing video frames, or checking a textbook solution. Remember that these times describe the projectile’s center of mass under constant downward gravity. A thrown ball with substantial drag, a powered rocket, or an object launched from a platform toward a level below its starting point requires a broader motion model. Via the API, each calculation costs $0.002; the deterministic response is convenient for automated worksheets and simulation checks.

Check a physics exercise

Compare both quadratic roots with a worked solution and confirm that the requested level lies below the apex.

Time a height-triggered sensor

Estimate the upward and downward moments when an ideal projectile crosses a sensor’s elevation.

Validate a simple simulation

Use deterministic analytic crossing times as reference values for a discrete projectile-motion simulation.

Why are there two times?

Below the apex, the projectile crosses the same height once while rising and once while falling.

What happens at maximum height?

The two roots are equal because the projectile reaches the apex at a single instant.

Why is my target height unreachable?

The selected vertical launch speed is insufficient to reach that height under the specified gravity.

Does the calculation include air resistance?

No. It uses ideal projectile motion with constant downward gravity and no drag, wind, lift, or propulsion.

Can I use gravity for another planet?

Yes. Supply any positive gravitational acceleration in meters per second squared that suits the idealized scenario.

What does an API calculation cost?

Each request costs $0.002.

Everything on this page is available programmatically. This section is for teams who want to wire it into their own systems; everyone else can just use the tool above.

POSThttps://api.kit.forhosting.com/mech/projectile-time-at-height

Prefer to automate it? One authenticated POST creates the task; the result comes back by webhook or a signed link. The same capability also runs here on the web, by email and from Telegram — and soon from our app too.

curl -X POST https://api.kit.forhosting.com/mech/projectile-time-at-height \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"speed":20,"angle_degrees":60,"height":10}'
{
  "speed": 20,
  "angle_degrees": 60,
  "height": 10
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "mech.projectile_time_at_height",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

The API is asynchronous: the call returns a task_id immediately and the result arrives by webhook. Polling is capped at 1 req/s per task.

Per request$0.002

Published price — no tokens, no invented credits. A failed task is never charged.

HTTPCodeMeaning
401unauthorizedMissing or invalid API key.
402insufficient_balanceYour balance doesn't cover the task price.
404unknown_typeThat task type doesn't exist.
429rate_limitedToo many requests. Use the webhook instead of polling.

Read the full KIT documentation →