API - URL

This page describes how to construct a Jakartowns URL to open the application at a specific position.

Thanks to this simple and powerful API, you're just a click away from integrating the Jakartowns digital twin into any business application. A simple click will open the application directly at a specific position by building your own URL.

Position Customization

One of the benefits of constructing the Jakartowns URL is the ability to customize the display position in the application. To do this, you can create a custom URL that will open the application centered on the geographic coordinates you specify.

Building the URL

To construct the custom URL, you will need the following parameters:

latitude (required): Specify the latitude value to center the display of the map application on a specific point.
longitude (required): Specify the longitude value to center the display of the map application on a specific point.
tilt (optional): Use this value to adjust the vertical tilt of the view. 0 corresponds to horizontal; 3.14/2 corresponds to the zenith; -3.14/2 corresponds to the nadir.
pan (optional): Set this value to adjust the horizontal rotation of the view. This angle is oriented toward the North of the projection system. 0 corresponds to North 3.14/2 corresponds to West 3.14 corresponds to South
fov (optional): Use this parameter to adjust the field of view of the application. This value ranges from 10 (very zoomed in) to 100 (default view).
year (optional): Add this value to display map data for a specific year.

By default, Jakartowns will open the closest and most recent view to the specified position and target the given latitude/longitude.

Example of Minimal Usage

You can now combine these parameters in the URL as follows:

https://maps.jakarto.com/?lat={latitude_value}&lng={longitude_value}

Replace {latitude_value}, {longitude_value} with the corresponding numeric values you want to use.

Example of Advanced Usage

https://maps.jakarto.com/?lat={latitude_value}&lng={longitude_value}&pan={pan_value}&tilt={tilt_value}&fov={fov_value}&year={year_value}

Replace {latitude_value}, {longitude_value}, {pan_value}, {tilt_value},{fov_value}, and {year_value} with the corresponding numeric values you want to use.

The values for pan, tilt, fov, and year are optional and will default to standard values if not specified.

The pan orientation will be automatically calculated to target the specified latitude/longitude.

A Unique Mapping Experience

Using the URL API gives you control over how you share the digital twin with your users. Customize display positions based on your application's needs and provide a simple yet immersive mapping experience.