> For the complete documentation index, see [llms.txt](https://docs.jakarto.com/guide-jakartowns/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jakarto.com/guide-jakartowns/fr/developpeurs/api-url.md). # API - URL 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 : 1. **latitude (obligatoire) :** Spécifiez la valeur de la latitude pour centrer l'affichage de l'application cartographique sur un point précis. 2. **longitude (obligatoire) :** Indiquez la valeur de la longitude pour centrer l'affichage de l'application cartographique sur un point précis. 3. **tilt (optionnel) :** Utilisez cette valeur pour ajuster l'inclinaison verticale de la vue. \\ *0 correspond à l'horizontal;*\ \&#xNAN;*3.14/2 correspond au zénith;*\ \&#xNAN;*-3.14/2 correspond au nadir.* 4. **pan (optionnel) :** Définissez cette valeur pour régler la rotation horizontale de la vue.\ \&#xNAN;*Cet angle est orienté vers le Nord du système de projection.*\ \&#xNAN;*0 correspond au Nord*\ \&#xNAN;*3.14/2 correspond à l'ouest*\ \&#xNAN;*3.14 correspond au Sud* 5. **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). 6. **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 : ```javascript 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 ```javascript 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. ### Démonstration : 2022 : {% embed url="" %}
2023 : {% embed url="" %}
*** Pour que votre application bénéficie d'une expérience encore plus intégrée, nous vous invitons à découvrir l'[API JavaScript](/guide-jakartowns/fr/developpeurs/api-javascript.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.jakarto.com/guide-jakartowns/fr/developpeurs/api-url.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.