API - URL

Cette page décrit comment construire l'URL de Jakartowns pour ouvrir l'application à une position donnée.

Grâce à cette API simple et puissante, vous êtes à un clic d'intégrer le jumeau numérique Jakartowns dans toute application métier. Un simple clic ouvrira l'application directement à une position spécifique en construisant votre propre URL.

Personnalisation de la Position

L'un des avantages de la construction de l'URL de Jakartowns est la possibilité de personnaliser la position d'affichage dans l'application. Pour cela, vous pouvez créer une URL sur mesure qui permettra à l'application de s'ouvrir avec une vue centrée sur les coordonnées géographiques que vous spécifiez.

Construire l'URL

Pour construire l'URL personnalisée, vous aurez besoin des paramètres suivants :

latitude (obligatoire) : Spécifiez la valeur de la latitude pour centrer l'affichage de l'application cartographique sur un point précis.
longitude (obligatoire) : Indiquez la valeur de la longitude pour centrer l'affichage de l'application cartographique sur un point précis.
tilt (optionnel) : Utilisez cette valeur pour ajuster l'inclinaison verticale de la vue. \
0 correspond à l'horizontal; 3.14/2 correspond au zénith; -3.14/2 correspond au nadir.
pan (optionnel) : Définissez cette valeur pour régler la rotation horizontale de la vue. Cet angle est orienté vers le Nord du système de projection. 0 correspond au Nord 3.14/2 correspond à l'ouest 3.14 correspond au Sud
fov (optionnel) : Utilisez ce paramètre pour ajuster le champ de vision de l'application. Cette valeur va de 10 (très zoomé) et 100 (vue par défaut).
year (optionnel) : Ajoutez cette valeur pour afficher des données cartographiques spécifiques à l'année désirée.

Par défaut, Jakartowns ouvrira la vue la plus proche et la plus récente de la position indiquée; et ciblera vers la latitude/longitude donnée.

Exemple d'utilisation minimale

Vous pouvez maintenant combiner ces paramètres dans l'URL de la manière suivante :

https://maps.jakarto.com/?lat={valeur_latitude}&lng={valeur_longitude}

Remplacez {valeur_latitude}, {valeur_longitude} par les valeurs numériques correspondantes que vous souhaitez utiliser.

Exemple d'utilisation avancée

https://maps.jakarto.com/?lat={valeur_latitude}&lng={valeur_longitude}&pan={valeur_pan}&tilt={valeur_tilt}&fov={valeur_fov}&year={valeur_year}

Remplacez {valeur_latitude}, {valeur_longitude}, {valeur_pan}, {valeur_tilt},{valeur_fov} et {valeur_year} par les valeurs numériques correspondantes que vous souhaitez utiliser.

Les valeurs de pan, tilt,fov et year sont optionnelles et prendront des valeurs par défaut si non spécifiées.

L'orientation pan sera calculée automatiquement pour cibler vers la latitude/longitude donnée.

Une Expérience Cartographique Unique

L'utilisation de l'API URL vous offre un contrôle sur la façon dont vous partagez le jumeau numérique avec vos utilisateurs. Personnalisez les positions d'affichage en fonction des besoins de votre application et offrez en toute simplicité une expérience cartographique unique et immersive.