Une seule interface pour rassembler des points d'intérêt, suivre les évènements en temps réel et composer des itinéraires à partir des lieux que choisissent vos utilisateurs. Installez-la chez vous quand vous voulez.
Lieux, restaurants, monuments, points de vue. Tout est agrégé, dédoublonné et enrichi à partir de 17 sources (OSM, Wikivoyage, Wikipedia, GeoNames, Foursquare, Baidu, Kakao, Navitime…). La sélection géo-intelligente se charge de choisir les providers les plus pertinents selon la région.
GET /pois/search?lat=…&lng=…Concerts, marchés, expositions ou festivals, récupérés depuis Ticketmaster, Eventbrite, Meetup, OpenAgenda et Wikipedia. Vous apportez vos clés à chaque requête, et vous filtrez par catégorie, distance ou date selon vos besoins.
GET /pois/events?lat=…&lng=…Vos utilisateurs sélectionnent leurs points, et l'API en tire un parcours fluide qui prend en compte le temps de visite, les horaires d'ouverture, le transport, et même la météo.
POST /itinerary/generateChaque provider est évalué par pays selon sa fiabilité, comme Baidu en Chine, Kakao en Corée ou Navitime au Japon. Vous pouvez laisser l'auto-sélection faire le travail, ou reprendre la main avec vos propres pondérations et listes d'exclusion.
GET /pois/providers/recommend› ▍
Si l'API est open source, c'est avant tout pour que vous puissiez la déployer sur vos propres serveurs, sans aucune limite. La version cloud reste là pour ceux qui souhaitent simplement essayer ou éviter la gestion d'infrastructure. Dans ce cas, ce que vous payez couvre uniquement le coût d'exécution sur nos machines.
Vos données restent chez vous, sur vos serveurs, sous vos règles. Pas de télémétrie, pas de plafond de tokens, pas de compte à créer. C'est tout simplement le mode que nous recommandons en production.
# 1. pull docker pull trippier/api:latest # 2. run docker run -p 8080:8080 \ -v trippier-data:/data \ trippier/api # 3. go curl localhost:8080/v1/healthz
Si vous préférez ne pas (encore) héberger vous-même, vous trouverez ici des endpoints prêts à l'emploi, un dashboard et la gestion de plusieurs clés.
Les sources gratuites (OSM, Wikivoyage, Wikipedia, GeoNames) sont actives par défaut. Vous pouvez ajouter vos propres clés pour Ticketmaster, Eventbrite, Meetup, Foursquare, Baidu, Kakao ou Navitime, via un header de requête ou une variable d'environnement.
OSM_OVERPASS_URL = sk_••••••••• # POI · free (built-in) = sk_••••••••• # POI · free (built-in) = sk_••••••••• # POI + Events GEONAMES_USERNAME = sk_••••••••• # POI · optional X-Ticketmaster-Key = sk_••••••••• # Events · BYOK X-Eventbrite-Token = sk_••••••••• # Events · BYOK
Sélectionnez une route, lancez-la, lisez la réponse réelle. Aucune clé requise pour les routes à 0 token.
/itinerary/generate Génère un itinéraire optimisé sur N jours. Fournissez soit une liste de POIs déjà sélectionnés (pois), soit une zone à explorer (poi_query) que le service délègue à GET /pois/search. Note : ce service est exposé sur un sous-domaine distinct (api.ai.* en production).
POST /itinerary/generate
Content-Type: application/json
{
"poi_query": {
"mode": "radius",
"lat": 45.76, "lng": 4.83,
"radius": 5000,
"types": ["see", "eat"],
"limit": 60
},
"days": 2,
"start_location": { "lat": 45.7610, "lng": 4.8320 },
"preferences": {
"pace": "moderate",
"priorities": ["see"],
"avoid": ["sleep"],
"start_time": "09:00",
"end_time": "21:00"
}
}// cliquez sur "Try it" pour exécuter
Un seul tarif, quel que soit votre volume. Il n'y a aucune marge sur l'API : les tokens financent simplement le compute, la bande passante et le cache de nos serveurs. La version self-hosted, elle, reste gratuite et illimitée.