• Api access
• Api integr exemple
• Api integr trails
• Api json trail
• Api json trail full
• Api key
• Api methods details
• Api services
• API V1
• Api v2
• API Version1
• Filtrage msq
• Liste des codes pays
• Liste des codes sport
• Requetes avancees sur SityAPI
• Statuts etoiles

Accès à l'API ¶

L’API Sity est accessible de manière générale aux adresse suivantes : ¶

Utilisation de la clef

Votre clef doit êtr utilisée de la manière suivante sur l’API :

http(s)://api.geolives.com/[[votre_clef_api]]/....

Par exemple :

http(s)://api.geolives.com/123ABCDE4DSFSDF5/Manager/?action=...

Api integr exemple¶

Intégrer mes SityGuides dans mon Site Web ¶

Comment fonctionne le module d'intégration ?

Quels sont les prérequis ? ¶

Procéder à l'intégration ¶

<script type="text/javascript" src="http://api.geolives.com/VOTRE_CLEF_API/TrailManager?action=intScript&lang=fr">

En cas de problème¶

Réglages avancés¶

Filtrage¶

Comment filtrer ? ¶

<script type="text/javascript" src="http://api.geolives.com/VOTRE_CLEF_API/TrailManager?action=intScript&lang=fr&filter=msq_ville=30007;activite=1;...">

Une présentation spécifique¶

Api json trail¶

{
    "status": "SUCCESS",
    "data": {
        "nb_max": 183,
        "trails": [
            {
                "id": 418025,                   // Identifiant unique du SityGuide
                "user": "alice",                // Utilisateur propriétaire 
                "auteur": "Alice R Mc Donald",  // Nom de l'auteur
                "statut": 3,                    // Statut (3 = public) 
                "difficulte": null,             // Difficulté ( 0 = très facile, 5 = très difficile , null/-1 = non défini )
                "longueur": 34800,              // Longueur du tracé en mètres
                "duree": 151,                   // Durée du parcours en minutes
                "denivelepositif": 676,         // Dénivelé positif en mètres
                "denivelenegatif": 663,         // Dénivelé négatif en mètres
                "activite": 5,                  // Activité - se référer au tableau des sports 
                "etoiles": 5,                   // Grade interne de la randonnée (4-5 = SityTour / 
                "distancereel": null,           // Distance réelle de la randonnée après recalcul
                "altitudemax": 425,             // Alt. max en mètres
                "altitudemin": 256,             // Alt. min en mètres 
                "closing": null,                // Période de fermeture 
                "idorigine": null,              // Cet identifiant est utilisé si le tracé provient d'un import, ceci est sa référence d'origine 
                "provenance": "Geolives",       // Provenance en cas d'import (Geolives = Provenance interne) 
                "balise": null,                 // Balise, si celle est est définie, consulter la page [[balise|Balise]] pour plus d'infos 
                "geom_wkt": "POINT(5.159668 50.007518)", // Coordonnées du point de départ
                "gpxminfo": {                   // Données statistiques de la randonnée 
                    "nbrVotes": null,                   // Nombre de votes pour la rando
                    "avgNote": null,                    // Moyenne des votes (/5)
                    "webCount": 49,                     // Nbre de visualisations web 
                    "mobileCount": 1,                   // Nbre de téléchargements mobile
                    "gpxCount": 0,                      // Nbre de téléchargements du fichier GPX 
                    "printCount": 0,                    // Nbre d'impressions 
                    "qrcodeCount": 2,                   // Nbre de scans du QR-CODE
                    "totalCount": 52                    // Total de téléchargements/Visualisation
                },
                // GPXM DATA Contient des informations additionnelles sur la localisation de la randonnée
                "gpxmdata": {                   
                    "id": 418025,                       // ID Unique 
                    "dateCreation": "2015-05-20",       // Date de création
                    "dateModification": "2015-05-20",   // Date de dernière modification
                    "spacialized": 1,                   // Spatialisation - donnée interne à ignorer
                    "ville": {                          // Ville 
                        "id": 32958,                        //  Identifiant de la ville
                        "name": "Libin",                    //  Nom de la ville/entité
                        "cp": "6890"                        //  Code postal 
                    },
                    "country": {                        // Pays
                        "id": 22,                           // Identifiant du pays
                        "iso2": "BE",                       // Code pays sur deux caractères
                        "iso3": "BEL",                      // Code pays sur trois caractères
                        "nameEn": "Belgique",               // Nom du pays
                        "nameFr": "Belgique",
                        "nameDe": null
                    },
                    "admin2": {                         // Admin 2 (province/département)
                        "id": 2660,                         // Identifiant
                        "name": "Luxembourg (le)",          // Nom de la province ou du dpt. 
                        "shortName": null                   // Nom raccourci (non utilisé) 
                    },
                    "admin1": {                         // Admin 1 (Région)
                        "id": 880,                      // Identifiant de la région
                        "name": "Région wallonne",     // Nom de la région
                        "shortName": null               // Nom raccourci (non utilisé)
                    }
                },
                // Entité contenant les informations textuelles multilingue concernant la randonnée
                // Se référer à la documentation pour plus d'info
                "mediaWithName": {                  
                    "idPoi": 3045101,               // Identification du POI de départ
                    "place": 0,                     // Place 0
                    "mediaCollection": [            // Media contenant les informations textuelles (plusieurs medias dans le cas de plusieurs langues) 
                        {
                            "idMedia": 4371028,         // IDentification du media. 
                            "langue": "fr",             // Langue
                            "descr": "Le départ de cette promenade est perdu.", // Texte descriptif 
                            "descrhtml": null,          // Description au format HTML (non utilisé) 
                            "titre": "Circuit des 3 Rivières", // Titre
                            "url": null,                // URL - champ non utilisé
                            "type": "zero"              // Type - type de media
                        }
                    ]
                },
                "vphotos": null,
                "latitude": 50.007518,
                "longitude": 5.159668
            }
        ]
    }
}

Api json trail full¶

{
    "status": "SUCCESS",
    "data": {
        "sit_data": [
            {
                "criteriaPlacesPK": {
                    "idCriteria": 1,
                    "idPlace": 12269
                },
                "valueString": null,
                "valueStringEn": null,
                "valueStringNl": null,
                "valueStringDe": null,
                "valueNumeric": 1,
                "valueDate": null,
                "valueDateInterval": null,
                "criteriaMultipleValuesCollection": [],
                "criteria": {
                    "criteriaWeight": 980,
                    "aliasCriteria": "thematique_foret",
                    "idCriteria": 1,
                    "criteriaNameFr": "Thématique forêt",
                    "criteriaNameNl": "Thema woud",
                    "criteriaNameEn": "Forest theme",
                    "criteriaNameDe": "Thema Wald",
                    "criteriaType": "boolean",
                    "public": 1
                }
            },
            {
                "criteriaPlacesPK": {
                    "idCriteria": 1008,
                    "idPlace": 12269
                },
                "valueString": null,
                "valueStringEn": null,
                "valueStringNl": null,
                "valueStringDe": null,
                "valueNumeric": 1,
                "valueDate": null,
                "valueDateInterval": null,
                "criteriaMultipleValuesCollection": [],
                "criteria": {
                    "criteriaWeight": 960,
                    "aliasCriteria": "thematique_zones_naturelles",
                    "idCriteria": 1008,
                    "criteriaNameFr": "Thématique zones naturelles",
                    "criteriaNameNl": "Thema natuurgebieden",
                    "criteriaNameEn": "Natural area theme",
                    "criteriaNameDe": "Thema natürliche Gebiete",
                    "criteriaType": "boolean",
                    "public": 1
                }
            },
            {
                "criteriaPlacesPK": {
                    "idCriteria": 1009,
                    "idPlace": 12269
                },
                "valueString": null,
                "valueStringEn": null,
                "valueStringNl": null,
                "valueStringDe": null,
                "valueNumeric": 1,
                "valueDate": null,
                "valueDateInterval": null,
                "criteriaMultipleValuesCollection": [],
                "criteria": {
                    "criteriaWeight": 950,
                    "aliasCriteria": "thematique_bord_eau",
                    "idCriteria": 1009,
                    "criteriaNameFr": "Thématique bord de l'eau",
                    "criteriaNameNl": "Thema waterkant",
                    "criteriaNameEn": "Waterside theme",
                    "criteriaNameDe": "Thema Wasserufer",
                    "criteriaType": "boolean",
                    "public": 1
                }
            },
            {
                "criteriaPlacesPK": {
                    "idCriteria": 1001,
                    "idPlace": 12269
                },
                "valueString": "25to50",
                "valueStringEn": null,
                "valueStringNl": null,
                "valueStringDe": null,
                "valueNumeric": null,
                "valueDate": null,
                "valueDateInterval": null,
                "criteriaMultipleValuesCollection": [],
                "criteria": {
                    "criteriaWeight": 940,
                    "aliasCriteria": "portion_asphaltee",
                    "idCriteria": 1001,
                    "criteriaNameFr": "Portion asphaltée (%)",
                    "criteriaNameNl": "Geasfalteerd gedeelte (%)",
                    "criteriaNameEn": "Tarmac portion (%)",
                    "criteriaNameDe": "Asphaltierter Anteil (%)",
                    "criteriaType": "list",
                    "public": 1
                }
            },
            {
                "criteriaPlacesPK": {
                    "idCriteria": 1002,
                    "idPlace": 12269
                },
                "valueString": "50to75",
                "valueStringEn": null,
                "valueStringNl": null,
                "valueStringDe": null,
                "valueNumeric": null,
                "valueDate": null,
                "valueDateInterval": null,
                "criteriaMultipleValuesCollection": [],
                "criteria": {
                    "criteriaWeight": 930,
                    "aliasCriteria": "portion_foret",
                    "idCriteria": 1002,
                    "criteriaNameFr": "Portion en foret (%)",
                    "criteriaNameNl": "Bosgedeelte (%)",
                    "criteriaNameEn": "Forest portion (%)",
                    "criteriaNameDe": "Waldanteil (%)",
                    "criteriaType": "list",
                    "public": 1
                }
            },
            {
                "criteriaPlacesPK": {
                    "idCriteria": 1003,
                    "idPlace": 12269
                },
                "valueString": null,
                "valueStringEn": null,
                "valueStringNl": null,
                "valueStringDe": null,
                "valueNumeric": 1,
                "valueDate": null,
                "valueDateInterval": null,
                "criteriaMultipleValuesCollection": [],
                "criteria": {
                    "criteriaWeight": 920,
                    "aliasCriteria": "accessibilite_pmr",
                    "idCriteria": 1003,
                    "criteriaNameFr": "Accessibilité PMR",
                    "criteriaNameNl": "PMR-bereikbaarheid",
                    "criteriaNameEn": "Disabled access",
                    "criteriaNameDe": "Behindertengerecht",
                    "criteriaType": "boolean",
                    "public": 1
                }
            },
            {
                "criteriaPlacesPK": {
                    "idCriteria": 1004,
                    "idPlace": 12269
                },
                "valueString": null,
                "valueStringEn": null,
                "valueStringNl": null,
                "valueStringDe": null,
                "valueNumeric": 1,
                "valueDate": null,
                "valueDateInterval": null,
                "criteriaMultipleValuesCollection": [],
                "criteria": {
                    "criteriaWeight": 910,
                    "aliasCriteria": "accessibilite_poussette",
                    "idCriteria": 1004,
                    "criteriaNameFr": "Accessibilité poussette",
                    "criteriaNameNl": "Bereikbaarheid met kinderwagen",
                    "criteriaNameEn": "Pushchair access",
                    "criteriaNameDe": "Mit Kinderwagen zugänglich",
                    "criteriaType": "boolean",
                    "public": 1
                }
            },
            {
                "criteriaPlacesPK": {
                    "idCriteria": 1017,
                    "idPlace": 12269
                },
                "valueString": null,
                "valueStringEn": null,
                "valueStringNl": null,
                "valueStringDe": null,
                "valueNumeric": 1,
                "valueDate": null,
                "valueDateInterval": null,
                "criteriaMultipleValuesCollection": [],
                "criteria": {
                    "criteriaWeight": 900,
                    "aliasCriteria": "panneaux_didactiques",
                    "idCriteria": 1017,
                    "criteriaNameFr": "Présence de panneaux didactiques",
                    "criteriaNameNl": "Aanwezigheid van infoborden",
                    "criteriaNameEn": "Information panels displayed",
                    "criteriaNameDe": "Informationstafeln sind vorhanden",
                    "criteriaType": "boolean",
                    "public": 1
                }
            },
            {
                "criteriaPlacesPK": {
                    "idCriteria": 1010,
                    "idPlace": 12269
                },
                "valueString": null,
                "valueStringEn": null,
                "valueStringNl": null,
                "valueStringDe": null,
                "valueNumeric": 1,
                "valueDate": null,
                "valueDateInterval": null,
                "criteriaMultipleValuesCollection": [],
                "criteria": {
                    "criteriaWeight": 890,
                    "aliasCriteria": "accessible_tec",
                    "idCriteria": 1010,
                    "criteriaNameFr": "Accessible en transports en commun",
                    "criteriaNameNl": "Toegankelijk met openbaar vervoer",
                    "criteriaNameEn": "Public transport access",
                    "criteriaNameDe": "Mit öffentlichen Verkehrsmitteln erreichbar",
                    "criteriaType": "boolean",
                    "public": 1
                }
            },
            {
                "criteriaPlacesPK": {
                    "idCriteria": 1011,
                    "idPlace": 12269
                },
                "valueString": null,
                "valueStringEn": null,
                "valueStringNl": null,
                "valueStringDe": null,
                "valueNumeric": 1,
                "valueDate": null,
                "valueDateInterval": null,
                "criteriaMultipleValuesCollection": [],
                "criteria": {
                    "criteriaWeight": 880,
                    "aliasCriteria": "restauration",
                    "idCriteria": 1011,
                    "criteriaNameFr": "Restauration le long du parcours - à proximité",
                    "criteriaNameNl": "Restauratie langs route - in de buurt",
                    "criteriaNameEn": "Restaurants along trail - nearby",
                    "criteriaNameDe": "Gastronomie am Parcours – in der Nähe",
                    "criteriaType": "boolean",
                    "public": 1
                }
            },
            {
                "criteriaPlacesPK": {
                    "idCriteria": 1012,
                    "idPlace": 12269
                },
                "valueString": null,
                "valueStringEn": null,
                "valueStringNl": null,
                "valueStringDe": null,
                "valueNumeric": 1,
                "valueDate": null,
                "valueDateInterval": null,
                "criteriaMultipleValuesCollection": [],
                "criteria": {
                    "criteriaWeight": 870,
                    "aliasCriteria": "piquenique_barbecue",
                    "idCriteria": 1012,
                    "criteriaNameFr": "Aires de pique-nique ou de barbecue",
                    "criteriaNameNl": "Picknick- of barbecuezones",
                    "criteriaNameEn": "Picnic or barbecue areas",
                    "criteriaNameDe": "Picknick- oder Grillplätze",
                    "criteriaType": "boolean",
                    "public": 1
                }
            },
            {
                "criteriaPlacesPK": {
                    "idCriteria": 12,
                    "idPlace": 12269
                },
                "valueString": null,
                "valueStringEn": null,
                "valueStringNl": null,
                "valueStringDe": null,
                "valueNumeric": 334545,
                "valueDate": null,
                "valueDateInterval": null,
                "criteriaMultipleValuesCollection": [],
                "criteria": {
                    "criteriaWeight": 500,
                    "aliasCriteria": "trail_id",
                    "idCriteria": 12,
                    "criteriaNameFr": "ID randonnée",
                    "criteriaNameNl": "ID wandeling",
                    "criteriaNameEn": "Trail ID",
                    "criteriaNameDe": "ID Wanderweg",
                    "criteriaType": "int",
                    "public": 0
                }
            }
        ],
        "trail": {
            "id": 334545,
            "user": "grande_foret_sthubert",
            "auteur": "grande_foret_sthubert",
            "statut": 3,
            "difficulte": 1,
            "longueur": 4700,
            "duree": 77,
            "denivelepositif": 95,
            "denivelenegatif": 94,
            "activite": 1,
            "etoiles": 5,
            "distancereel": null,
            "altitudemax": 320,
            "altitudemin": 260,
            "closing": null,
            "idorigine": "25 - Saint-Hubert (26) - Marsoult",
            "provenance": "Geolives",
            "balise": 1,
            "poiCollection": [
                {
                    "idPoi": 2884423,
                    "place": 8,
                    "symbol": "http://google-maps-icons.googlecode.com/files/ancienttempleruin.png",
                    "adressStreet": "",
                    "adressNumber": "",
                    "adressBox": "",
                    "adressCp": "",
                    "adressLocality": "",
                    "adressCountry": "",
                    "contactName": "",
                    "contactFirstname": "",
                    "contactPhone": "",
                    "contactFax": "",
                    "contactEmail": "",
                    "contactWebsite": "",
                    "contactFonction": "",
                    "type": "Ancienttempleruin",
                    "contactCivilite": "",
                    "mediaCollection": [
                        {
                            "idMedia": 4169632,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Haut Fourneau restauré",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=d0a48607-2dae-4062-8ae3-89cc9a0b6d36.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169631,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Restauration terrassement",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=6c23171a-f551-4944-9d18-cf3c86ca6c8f.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169630,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Restauration nettoyage des ruines",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=2465bd9f-5a47-4fd4-b321-c8aceb2c9989.JPG",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169629,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Restauration nettoyage des ruines",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=3608f6dd-78f9-4787-afaf-b55cc820b4af.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169628,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Resauration Pose toiture et réparation maçonnerie",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=2fb97e75-ec84-41b8-8863-d6003e17f45d.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169627,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Restauration Pose charpente",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=f3f0525f-ae70-4f31-95b8-0bd97389ecd5.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169626,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Restauration pose lamellé collé",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=40f6a501-fb5d-4c92-8f44-b8f9bf259a5b.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169625,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Le site en 2004",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=c70034c8-6361-426a-9b8d-7bf4978dfabb.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169624,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Fouilles, de 1984 à 1992",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=65741512-d8b8-408a-93db-7aff3d554516.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169623,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Peinture de Brueghel",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=9ff080ad-dd14-4770-b4dc-737b719574a5.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169622,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Haut Fourneau restauré",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=37f64c21-cd8d-4981-b015-8764ac139915.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169621,
                            "langue": "fr",
                            "descr": "C'est la fin du Moyen Âge,une période riche en découvertes commence.\nEn 1536, le Seigneur de Mirwart décide de construire un haut fourneau à Marsolle pour y fabriquer du fer et engage aussitôt un maître des forges et des sidérurgistes. En effet, on trouve en cet endroit trois ressources intéressantes : l'eau, le bois et du minerai. Le haut fourneau sera utilisé jusqu'en 1568.\nDes bûcherons, des charbonniers et des mineurs travaillaient à proximité du site. La forêt est surexploitée. Le haut fourneau consomme à lui seul plusieurs milliers de m³ de bois par an.\nOn utilise une technique wallonne qui a révolutionné son époque : le \"procédé indirect\", ou encore la fabrication du fer en deux étapes, au lieu d'une. Les gueuzes de fonte (poutres de fer contenant beaucoup de carbone) seront ensuite retravaillées et purifiées afin de produire du fer de qualité dans une forge d'affinage située au pied du château. \n\n\n\n",
                            "descrhtml": null,
                            "titre": "Haut fourneau de Marsolle",
                            "url": null,
                            "type": "poi_zero"
                        }
                    ],
                    "geometryWkt": "POINT(5.237635374069214 50.036194190130736)"
                },
                {
                    "idPoi": 2884422,
                    "place": 7,
                    "symbol": "http://google-maps-icons.googlecode.com/files/info.png",
                    "adressStreet": "",
                    "adressNumber": "",
                    "adressBox": "",
                    "adressCp": "",
                    "adressLocality": "",
                    "adressCountry": "",
                    "contactName": "",
                    "contactFirstname": "",
                    "contactPhone": "",
                    "contactFax": "",
                    "contactEmail": "",
                    "contactWebsite": "",
                    "contactFonction": "",
                    "type": "Info",
                    "contactCivilite": "",
                    "mediaCollection": [
                        {
                            "idMedia": 4169620,
                            "langue": "fr",
                            "descr": "Autour d’une cheminée centrale, le charbonnier empile des rondins pour obtenir une meule qu’il recouvre de terre.\nPendant environ une semaine le bois est carbonisé à l’abri de l’air ; l’eau, les matières végétales sont éliminées.\n\nOn ne récupère que  60% du volume, 20 % du poids des rondins.\n\nLe charbon de bois chauffe plus fort sans perdre d’énergie dans de longues flammes, le vent l��attise sans pouvoir l’étendre.\nLes charbonniers, d’un caractère rude et courageux vivaient plusieurs semaines en forêts et surveillaient leur meule pour éviter qu’elle ne s’ouvre par accident et que tout le bois se consume.",
                            "descrhtml": null,
                            "titre": "Quand la forêt s'en allait en charbon",
                            "url": null,
                            "type": "poi_zero"
                        }
                    ],
                    "geometryWkt": "POINT(5.245553255081177 50.05025011831853)"
                },
                {
                    "idPoi": 2884421,
                    "place": 6,
                    "symbol": "http://google-maps-icons.googlecode.com/files/info.png",
                    "adressStreet": "",
                    "adressNumber": "",
                    "adressBox": "",
                    "adressCp": "",
                    "adressLocality": "",
                    "adressCountry": "",
                    "contactName": "",
                    "contactFirstname": "",
                    "contactPhone": "",
                    "contactFax": "",
                    "contactEmail": "",
                    "contactWebsite": "",
                    "contactFonction": "",
                    "type": "Info",
                    "contactCivilite": "",
                    "mediaCollection": [
                        {
                            "idMedia": 4169619,
                            "langue": "fr",
                            "descr": "Les milieux humides sont propices au foisonnement de la vie, ils abritent des communautés vivantes très variées de plantes, insectes, poissons, batraciens, oiseaux,….\n\nLa vég����tation est luxuriante, les animaux abondants.\n\nLa cigogne noire de retour depuis les années 90 recherche les petits ruisseaux peu profonds où elle chasse les truites, insectes et batraciens.\n\nLa grenouille verte se nourrit de mouches, moustique, limaces… sous l’eau elle nage en zig zag.\nL’assèchement des zones humides lui est fatal !\n\nA l’étang Saint Roch, les inflorescences roses de la renouée amphibie  sont propices à la rêverie.\n",
                            "descrhtml": null,
                            "titre": "Un haut-lieu de biodiversité",
                            "url": null,
                            "type": "poi_zero"
                        }
                    ],
                    "geometryWkt": "POINT(5.243031978607178 50.04670896348586)"
                },
                {
                    "idPoi": 2884420,
                    "place": 5,
                    "symbol": "http://google-maps-icons.googlecode.com/files/info.png",
                    "adressStreet": "",
                    "adressNumber": "",
                    "adressBox": "",
                    "adressCp": "",
                    "adressLocality": "",
                    "adressCountry": "",
                    "contactName": "",
                    "contactFirstname": "",
                    "contactPhone": "",
                    "contactFax": "",
                    "contactEmail": "",
                    "contactWebsite": "",
                    "contactFonction": "",
                    "type": "Info",
                    "contactCivilite": "",
                    "mediaCollection": [
                        {
                            "idMedia": 4169618,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Analyse des indices biotiques",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=0cf0addf-5b51-4d8d-a4db-a20cacfa5987.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169617,
                            "langue": "fr",
                            "descr": "Le ruisseau du Marsoult alimente les étangs en eau de bonne qualité.\nLa présence de nombreux invertébrés indicateurs d’eaux saines le confirme.\n\nPhoto : perles, éphémères, phryganes, libellules\n\nNous faisons très régulièrement des analyses (indice biotique) pour contrôler la qualité de l’eau en dénombrant ces petits animaux très importants dans le grand cycle de la vie.\n\nL’eau est fraîche et bien oxygénée grâce à la turbulence de son parcours Elle est aussi légèrement acide avec un ph de 6,9.\n\nLe débit du ruisseau varie de 400 litres/seconde en hiver à …. 60 litres/seconde en été, ce qui pose problèmes lors de fortes chaleurs.\n\nLes martins pêcheurs, le cincle plongeur raffolent de ce petit ruisseau plein de crustacés.\n",
                            "descrhtml": null,
                            "titre": "Analyser la qualité de l'eau",
                            "url": null,
                            "type": "poi_zero"
                        }
                    ],
                    "geometryWkt": "POINT(5.237313508987427 50.038109897076204)"
                },
                {
                    "idPoi": 2884419,
                    "place": 4,
                    "symbol": "http://google-maps-icons.googlecode.com/files/info.png",
                    "adressStreet": "",
                    "adressNumber": "",
                    "adressBox": "",
                    "adressCp": "",
                    "adressLocality": "",
                    "adressCountry": "",
                    "contactName": "",
                    "contactFirstname": "",
                    "contactPhone": "",
                    "contactFax": "",
                    "contactEmail": "",
                    "contactWebsite": "",
                    "contactFonction": "",
                    "type": "Info",
                    "contactCivilite": "",
                    "mediaCollection": [
                        {
                            "idMedia": 4169616,
                            "langue": "fr",
                            "descr": "Pendant longtemps le bois mort a été considéré comme un « nid à parasites » à éliminer.\nAujourd’hui, nous savons que c’était une erreur.\n\nLes vieux bois et arbres morts abritent une vie indispensable aux équilibres forestiers.\nLes milliers de petits insectes qui rongent les arbres morts nourrissent eux-mêmes des prédateurs dont les pics\n\nEnsuite ce sont les loirs, écureuils, martres, chauves-souris, mésanges, sitelles qui y trouvent refuge\nDepuis 2008, la loi oblige le forestier à conserver des arbres morts en forêts\n",
                            "descrhtml": null,
                            "titre": "Préserver les arbres morts",
                            "url": null,
                            "type": "poi_zero"
                        }
                    ],
                    "geometryWkt": "POINT(5.238279104232788 50.043477603967794)"
                },
                {
                    "idPoi": 2884418,
                    "place": 3,
                    "symbol": "http://google-maps-icons.googlecode.com/files/info.png",
                    "adressStreet": "",
                    "adressNumber": "",
                    "adressBox": "",
                    "adressCp": "",
                    "adressLocality": "",
                    "adressCountry": "",
                    "contactName": "",
                    "contactFirstname": "",
                    "contactPhone": "",
                    "contactFax": "",
                    "contactEmail": "",
                    "contactWebsite": "",
                    "contactFonction": "",
                    "type": "Info",
                    "contactCivilite": "",
                    "mediaCollection": [
                        {
                            "idMedia": 4169615,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Oiseau prédateur Héron cendré",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=d4dd62aa-3b13-444b-a945-5567ea6bf9ae.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169614,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Oiseau prédateur Cormoran",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=6edcf9a4-d3b3-4595-ab41-70a653915aa2.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169613,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Oiseau prédateur Balbuzard pêcheur",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=d9d9609c-b532-4330-a38e-028f11058ab6.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169612,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Oiseau prédateur Martin pêcheur",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=1c4d49a2-c4ed-4acd-b901-a9306b675099.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169611,
                            "langue": "fr",
                            "descr": "La force de l’eau était autrefois utilisée pour faire tourner des roues à aube et actionner les lames d’une scierie installée en contrebas. Les poutres du château actuel (1710) ont été sciées ici.\n\nAujourd’hui on y élève des truites.\nDes fils sont tendus au-dessus de l’eau pour empêcher les cormorans de venir prélever les poissons.\n\nLes cormorans se déplacent souvent en bande de plusieurs dizaines (d’individus).\nIls passent l’hiver chez nous, mais dès le printemps, la plupart s’en retourne vers les pays du nord de l’Europe.\n\nCet oiseau piscivore ingurgite à lui seul 600 gr de poisson chaque jour !\n\nAutre prédateur : le héron. Attaché au site de Mirwart, il y vit toute l’année.\nIl se nourrit de grenouille et poissons surtout.\n",
                            "descrhtml": null,
                            "titre": "Eviter les oiseaux pêcheurs",
                            "url": null,
                            "type": "poi_zero"
                        }
                    ],
                    "geometryWkt": "POINT(5.243182182312012 50.04853468878041)"
                },
                {
                    "idPoi": 2884417,
                    "place": 2,
                    "symbol": "http://google-maps-icons.googlecode.com/files/info.png",
                    "adressStreet": "",
                    "adressNumber": "",
                    "adressBox": "",
                    "adressCp": "",
                    "adressLocality": "",
                    "adressCountry": "",
                    "contactName": "",
                    "contactFirstname": "",
                    "contactPhone": "",
                    "contactFax": "",
                    "contactEmail": "",
                    "contactWebsite": "",
                    "contactFonction": "",
                    "type": "Info",
                    "contactCivilite": "",
                    "mediaCollection": [
                        {
                            "idMedia": 4169610,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Fécondation des oeufs",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=f9a3f1a4-4cc2-464f-a1fa-22f1ee10ad9c.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169609,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Laitance du mâle",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=66fa9f68-2d94-47f2-a02f-921505baa3bb.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169608,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Ponte femelle",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=4aa6d878-88d4-4b76-a2fb-8c04038e5528.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169607,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Ponte femelle",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=e7c81ace-7327-4ade-b3cc-0cde8080c007.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169606,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Géniteur",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=8a65832c-76b3-4129-ac1d-3f032e95c4c2.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169605,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Prélèvement des géniteur",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=f7ddd152-3386-4f54-aa4f-754fd0677dd8.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169604,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Pisciculture",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=8b48ebc7-803f-48a8-8b3a-53a071ed4d36.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169603,
                            "langue": "fr",
                            "descr": "Tout le cycle de l’élevage de la truite fario est réalisé à Mirwart.\n\nDessin du cycle annuel\n\nNaturellement les truites se reproduisent dans les premiers jours de l’hiver.\n\nAutre symbole des eaux pures : l’écrevisse à patte rouge.\n\nSa survie est menacée à cause de la pollution des cours d’eau, de  travaux d’aménagements sur les ruisseaux, et … d’une maladie importée en 1860 avec des écrevisses américaines porteuses d’un champignon auquel elle ne résiste pas.\n\nA Mirwart, nous élevons la « patte rouge » dans un objectif de sauvegarde de l’espèce et de sensibilisation.\n(réintroduction)\n",
                            "descrhtml": null,
                            "titre": "Elever la truite et l'écresisse",
                            "url": null,
                            "type": "poi_zero"
                        }
                    ],
                    "geometryWkt": "POINT(5.249737501144409 50.05425254879416)"
                },
                {
                    "idPoi": 2884416,
                    "place": 1,
                    "symbol": "http://google-maps-icons.googlecode.com/files/info.png",
                    "adressStreet": "",
                    "adressNumber": "",
                    "adressBox": "",
                    "adressCp": "",
                    "adressLocality": "",
                    "adressCountry": "",
                    "contactName": "",
                    "contactFirstname": "",
                    "contactPhone": "",
                    "contactFax": "",
                    "contactEmail": "",
                    "contactWebsite": "",
                    "contactFonction": "",
                    "type": "Info",
                    "contactCivilite": "",
                    "mediaCollection": [
                        {
                            "idMedia": 4169602,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Écrevisse à pattes rouges",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=24743c86-d20a-4d14-be62-48a66336b963.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169601,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Truite Fario",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=631c391b-9bde-4fc4-9f02-8932d12da976.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169600,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Truite Fario",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=9ca31235-ce2a-47e5-93f6-a71bcae197a9.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169599,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Pisciculture",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=fda24c43-9532-41b6-9e38-190d88dac089.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169598,
                            "langue": "all",
                            "descr": "",
                            "descrhtml": "",
                            "titre": "Pisciculture",
                            "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=72a67acd-c202-4ddf-b6d1-5198a39ae44b.jpg",
                            "type": "Image"
                        },
                        {
                            "idMedia": 4169597,
                            "langue": "fr",
                            "descr": "A Mirwart, on compte plus de 40 étangs.\nLes premiers étangs ont été creusés il y a plus de 350 ans…\nOn y élève aujourd’hui des truites farios, des écrevisses à pattes rouges, tous les deux indicateurs d’une eau de très bonne qualité.\nLes truites sont carnivores ; les poissons de tailles et d’âges différents vivent dans des étangs différents. La compétition pour la nourriture et l’espace y est féroce !\nAu total il y a en permanence plus de 200.000 poissons petits et grands.\n\nLes écrevisses plus discrètes sont élevées dans les étangs moins profonds, elles ne supportent pas la lumière et préfèrent se cacher sous les pierres.\n",
                            "descrhtml": null,
                            "titre": "La vallée du Marsoult et ses activités",
                            "url": null,
                            "type": "poi_zero"
                        }
                    ],
                    "geometryWkt": "POINT(5.251057147979736 50.05470030424679)"
                },
                {
                    "idPoi": 2884415,
                    "place": 0,
                    "symbol": "start",
                    "adressStreet": null,
                    "adressNumber": null,
                    "adressBox": null,
                    "adressCp": null,
                    "adressLocality": null,
                    "adressCountry": null,
                    "contactName": null,
                    "contactFirstname": null,
                    "contactPhone": null,
                    "contactFax": null,
                    "contactEmail": null,
                    "contactWebsite": null,
                    "contactFonction": null,
                    "type": null,
                    "contactCivilite": null,
                    "mediaCollection": [
                        {
                            "idMedia": 4169596,
                            "langue": "fr",
                            "descr": "C'est une des quatre promenades du Domaine provincial de Mirwart.\nElle débute en contournant les bâtiments de la pisciculture, là où le petit Marsoult rejoint la Lomme.\nLe Marsoult et les étangs qu'il alimente vous accompagneront tout au long de votre promenade, qui remontera puis redescendra l'étroite vallée où ce ruisseau a fait son lit.\nCette promenade est équipée de sept panneaux didactique sur les thèmes de la pisciculture et de la nature. ",
                            "descrhtml": null,
                            "titre": "Marsoult (26)",
                            "url": null,
                            "type": "zero"
                        }
                    ],
                    "geometryWkt": ""
                }
            ],
            "geom_wkt": "POINT(5.252071 50.053666)",
            "gpxminfo": {
                "nbrVotes": null,
                "avgNote": null,
                "webCount": 137,
                "mobileCount": 39,
                "gpxCount": 1,
                "totalCount": 177,
                "printCount": 0,
                "qrcodeCount": 0
            },
            "gpxmdata": {
                "id": 334545,
                "dateCreation": "2015-04-16",
                "dateModification": "2015-04-16",
                "spacialized": 1,
                "ville": {
                    "id": 29692,
                    "name": "Saint-Hubert",
                    "cp": "6870"
                },
                "country": {
                    "id": 22,
                    "iso2": "BE",
                    "iso3": "BEL",
                    "nameEn": "Belgique",
                    "nameFr": "Belgique",
                    "nameDe": null
                },
                "admin2": {
                    "id": 2660,
                    "name": "Luxembourg (le)",
                    "shortName": null
                },
                "admin1": {
                    "id": 880,
                    "name": "Région wallonne",
                    "shortName": null
                }
            },
            "mediaWithName": {
                "idPoi": 2884415,
                "place": 0,
                "symbol": "start",
                "adressStreet": null,
                "adressNumber": null,
                "adressBox": null,
                "adressCp": null,
                "adressLocality": null,
                "adressCountry": null,
                "contactName": null,
                "contactFirstname": null,
                "contactPhone": null,
                "contactFax": null,
                "contactEmail": null,
                "contactWebsite": null,
                "contactFonction": null,
                "type": null,
                "contactCivilite": null,
                "mediaCollection": [
                    {
                        "idMedia": 4169596,
                        "langue": "fr",
                        "descr": "C'est une des quatre promenades du Domaine provincial de Mirwart.\nElle débute en contournant les bâtiments de la pisciculture, là où le petit Marsoult rejoint la Lomme.\nLe Marsoult et les étangs qu'il alimente vous accompagneront tout au long de votre promenade, qui remontera puis redescendra l'étroite vallée où ce ruisseau a fait son lit.\nCette promenade est équipée de sept panneaux didactique sur les thèmes de la pisciculture et de la nature. ",
                        "descrhtml": null,
                        "titre": "Marsoult (26)",
                        "url": null,
                        "type": "zero"
                    }
                ],
                "geometryWkt": ""
            },
            "vphotos": {
                "idMedia": 4169632,
                "idPoi": 2884423,
                "langue": "all",
                "descr": "",
                "descrhtml": "",
                "titre": "Haut Fourneau restauré",
                "url": "http://www.sitytrail.com/GeolivesWS/DownloadMedia.ashx?TrailID=334545&Media=d0a48607-2dae-4062-8ae3-89cc9a0b6d36.jpg",
                "type": "Image",
                "idRando": 334545,
                "place": 8
            },
            "latitude": 50.053666,
            "longitude": 5.252071
        },
        "geom": "LINESTRING(5.252071 50.053666 -9999 0,5.251756 50.054116 -9999 0,5.251569 50.054843 -9999 0,5.251215 50.054929 -9999 0,5.250923 50.054883 -9999 0,5.250477 50.054744 -9999 0,5.250084 50.05445 -9999 0,5.249729 50.054262 -9999 0,5.249459 50.054038 -9999 0,5.249054 50.05391 -9999 0,5.248759 50.053829 -9999 0,5.248403 50.053535 -9999 0,5.247957 50.053348 -9999 0,5.247343 50.053091 -9999 0,5.246841 50.052928 -9999 0,5.246442 50.052729 -9999 0,5.246036 50.052328 -9999 0,5.245605 50.052022 -9999 0,5.245116 50.051597 -9999 0,5.244866 50.051088 -9999 0,5.244596 50.050602 -9999 0,5.244184 50.050106 -9999 0,5.243921 50.049715 -9999 0,5.244641 50.049436 -9999 0,5.244326 50.049105 -9999 0,5.243643 50.048789 -9999 0,5.243139 50.048496 -9999 0,5.24266 50.047976 -9999 0,5.24221 50.047492 -9999 0,5.241802 50.047102 -9999 0,5.24148 50.046689 -9999 0,5.241068 50.046359 -9999 0,5.240618 50.045993 -9999 0,5.240205 50.045628 -9999 0,5.239716 50.045144 -9999 0,5.239301 50.044659 -9999 0,5.238771 50.043973 -9999 0,5.238414 50.043667 -9999 0,5.238157 50.043324 -9999 0,5.237977 50.04304 -9999 0,5.238009 50.042694 -9999 0,5.237842 50.042362 -9999 0,5.237707 50.042054 -9999 0,5.237617 50.041567 -9999 0,5.237556 50.041128 -9999 0,5.237435 50.040605 -9999 0,5.237302 50.039988 -9999 0,5.237344 50.039654 -9999 0,5.237482 50.039249 -9999 0,5.237683 50.039033 -9999 0,5.237751 50.038688 -9999 0,5.237662 50.038439 -9999 0,5.237302 50.038132 -9999 0,5.2373 50.037548 -9999 0,5.237701 50.037879 -9999 0,5.238225 50.038375 -9999 0,5.238607 50.038776 -9999 0,5.238778 50.039263 -9999 0,5.238788 50.039738 -9999 0,5.238688 50.040429 -9999 0,5.238716 50.040964 -9999 0,5.238724 50.041369 -9999 0,5.238826 50.041915 -9999 0,5.239283 50.04228 -9999 0,5.239778 50.042538 -9999 0,5.23986 50.042942 -9999 0,5.239886 50.043311 -9999 0,5.240273 50.043724 -9999 0,5.240751 50.04416 -9999 0,5.241264 50.044597 -9999 0,5.24197 50.045186 -9999 0,5.242705 50.045728 -9999 0,5.2432 50.046188 -9999 0,5.243471 50.046721 -9999 0,5.243729 50.047445 -9999 0,5.243876 50.048193 -9999 0,5.244214 50.048737 -9999 0,5.244371 50.049105 -9999 0,5.244726 50.049435 -9999 0,5.245087 50.049944 -9999 0,5.245407 50.050334 -9999 0,5.245902 50.050759 -9999 0,5.246532 50.051253 -9999 0,5.247468 50.051877 -9999 0,5.24868 50.052498 -9999 0,5.249775 50.05293 -9999 0,5.25063 50.053375 -9999 0,5.251193 50.053478 -9999 0,5.251846 50.053579 -9999 0,5.251981 50.053594 -9999 0,5.252089 50.053599 -9999 0)"
    }
}

Accéder à l'API avec une clef d'accès¶

L’accès à l’API nécessite l’obtention d’une clef personnelle unique qui devra être fournie à chaque appel de l’API.
Cette clef définit l’utilisateur ainsi que les droits d’accès et limitations qui lui sont attribuées.
L’utilisation de l’API n’est pas gratuite et nécessite de disposer d’un contrat avec Geolives (voir ci-dessous). En fonction du contrat ou des accords, certaines fonctionnalités seront libérées, bloquées ou limitées.

Comment obtenir une clef ?¶

L’obtention d’une clef nécessite la souscription d’au moins un contrat de type professionnel avec Geolives tel que SityTour ou SityTrail (Pro >= 10 licences) ainsi que la génération de celle-ci depuis une page dédiée.
Cette clef est strictement personnelle et confidentielle.
Aussi, l’utilisateur veillera à ne pas divulguer cette clef d’accès à des tiers ou au public car celle-ci permet potentiellement d’accéder à tous les paramètres du compte SityTrail et peut avoir un impact sur la facturation.

Lorsque votre demande est acceptée et que l'accès est activé, vous recevez une clef d'accès composée de chiffres et de lettres. Cette clef est a utiliser pour tous les modules externes Sity.

Afin d'obtenir votre clef, merci de nous contacter à l'adresse help.pro@geolives.com en mentionnant votre nom d'utilisateur 

Exemple de clef : 

​jsd124areg2558uff2fg5gju86tff

Comment utiliser la clef obtenue ?¶

Il est nécessaire d'insérer systématiquement la clef dans chaque appel à l'API. 

Consultez l'article détaillé à propos de l' accès à l'API

 ¶

Description des méthodes de l'API TrailManager¶

• Description des méthodes de l'API TrailManager
  • GetTrails
  • GetTrailsJSON
  • GetTrailDetails
  • intScript

GetTrails¶

http://api.geolives.com/API_KEY/TrailManager?action=getTrails&page=1

GetTrailsJSON¶

http://api.geolives.com/API_KEY/TrailManager?action=getTrailsJSON

GetTrailDetails¶

http://api.geolives.com/API_KEY/TrailManager?action=getTrailDetails

intScript¶

http://api.geolives.com/API_KEY/TrailManager?action=intScript

http://api.geolives.com/VOTRE_CLEF_API/TrailManager?action=intScript&lang=fr&filter=msq_ville=30007;activite=1;...

Services d'API¶

Liste des fonctions¶

SityTour - Gestion des randonnées¶

SityTour - Intégration des randonnées¶

SityTour - MoneyTour

SityTour - Incidents¶

API V1¶

Nouveau : API SityTour V2

Accéder à la documentation de l’API V2
 

L’API SityAPI

• API V1
  • Cette API est dépréciée
    • Intégration Iframe
    • Intégration PHP
    • Appels directs à SityAPI
  • Contraintes
  • Instruction d’utilisation de l’API d’intégration de randonnées
    • Iframe
    • Script PHP
      • Description des paramètres
    • En savoir plus

SityTour propose un ensemble d’outil de diffusion de circuits de randonnées (applications mobiles, sorties papier, site web).
SityAPI propose aux webmasters d’intégrer directement les circuits de randonnées au sein de leur site web ou leur outil de gestion.

La seule condition au bon fonctionnement est de disposer d’un espace d’au moins 600px de large sur votre site.

En fonction des besoins et des capacités techniques du site sur lequel les randonnées doivent être intégrées, deux types d’intégration sont proposés :

Intégration Iframe¶

Méthode d’intégration la plus simple : Un simple copier-coller de script permet l’intégration des données dans la plupart des CMS ou sites web.

Avantages
* Simplicité d’utilisation
* Rapidité, peu de configuration
* Intégration possible dans n’importe quel site web

Inconvénients
* Pas d’indexation : Les randonnées intégrées ne seront pas répertoriées dans les différents moteurs de recherche
* Rigidité : Seules des options de base sont disponibles (filtrage fixe)
* Style préétabli : Les randonnées intégrées sont présentées au sein d’une charte graphique neutre.

Intégration PHP¶

Cette méthode consiste à place un script d’intégration PHP au sein du site client. Lors de chaque requête le script est exécuté sur le serveur du client et celui-ci traduit la requête utilisateur en requête compréhensible par le serveur SityAPI. Les résultats sont en suite affichés au sein du site client de manière totalement transparente, donnant l’illusion que les résultats sont produits par le site client lui même.

Avantages
* Cohésion avec le site client. Les résultats sont affichés selon la charte graphique du site client
* Flexibilité : différents filtres peuvent être préétablis
* Extensible : Le client peut séparer les résultats en plusieurs pages avec des filtres préétablis (p.ex : toutes les randonnées en vélo, à cheval, etc.) ou encore y adjoindre son propre moteur de recherche
* Les résultats sont lus et indexés par les moteurs de recherche

Inconvénients
* Le site client doit être capable d’exécuter du code PHP.
* L’intégration peut nécessiter un temps un petit peu plus important.
* En fonction de la complexité de la charte graphique et de la feuille de style utilisée, les résultats affichés peuvent nécessiter quelques adaptations.

Appels directs à SityAPI¶

L’utilisateur dispose de la possibilité de programmer ses propres appels à l’API et ainsi paramétrer différents filtres ou développer un moteur de recherche plus avancé.

Avantages
* Grande flexibilité : Possibilité de défnir un nombre infini de possibilités.

Inconvénients
* Programmation plus lourde : Tous les appels doivent être programmés.
* Cette méthode n’est pas officiellement supportée : La possibilité est laissée aux utilisateurs SityAPI de programmer leur propre client. Cette méthode étant la moins courante et le nombre de clients potentiels illimités, Geolives n’est pas en mesure de fournir de support technique pour l’utilisation de cette méthode.

Contraintes¶

• SityAPI est disponible pour tous les clients SityTour en tant que composante de la solution. L’intégration reste cependant à charge du client et Geolives ne propose pas de prestations d’intégration.
• Ce service est proposé uniquement dans le but de permettre la consultation des randonnées dans un site client. L’utilisation à d’autres fins, telles que l’aspiration de données ou la copie de randonnées peut entrainer la suspension du compte.
• Le client est prié d’avertir Geolives préalablement à toute montée en charge prévisible (Évènement, publicité, annonce dans les médias, nouveau partenariat) afin d’éventuellement adapter l’infrastructure à absorber le flux de visiteurs.

Instruction d’utilisation de l’API d’intégration de randonnées¶

Iframe¶

Le code suivant peut être intégré dans une page. Il sera nécessaire d’y indiquer son nom d’utilisateur afin de filtrer la liste sur ses randonnées.
Les dimensions peuvent être adaptées afin de s’intégrer le mieux possible dans votre page.

Les paramètres de filtrage indiqués dans la présente documentation peuvent être également appliqués à l’URL de l’iframe pour créer des pages thématiques.

Script PHP¶

Le script suivant permet l’intégration des randonnées dans un site web :

<!--?php <?php $geolives_user = "chevreuse";// DEFINIR ICI LE NOM D'UTILISATEUR $geolives_basepage="http://sitytour.net/testchevreuse/"; // <=== CHANGER ICI =======CHANGER ICI===========CHANGER ICI======CHANGER ICI $geolives_lang ="fr"; // -- PARAMETRES AVANCES------------------------------------- $geolives_Nville = (isset($_GET['Nville']))?$_GET['Nville']:""; $geolives_country=(isset($_GET['country']))?$_GET['country']:""; $geolives_admin1=(isset($_GET['admin1']))?$_GET['admin1']:""; $geolives_admin2=(isset($_GET['admin2']))?$_GET['admin2']:""; $geolives_onlygold=(isset($_GET['onlygold']))?$_GET['onlygold']:""; $geolives_ville=(isset($_GET['ville']))?$_GET['ville']:""; $geolives_category=(isset($_GET['category']))?$_GET['category']:""; // -- NE RIEN MODIFIER SOUS CETTE LIGNE -- $geolives_idrando=(isset($_GET['idrando']))?$_GET['idrando']:""; $geolives_type=(isset($_GET['randotype']))?$_GET['randotype']:"list"; $geolives_user=($geolives_user=="" && isset($_GET['username'])) ? $_GET['username']:$geolives_user; $geolives_maxsize="medium"; // Taille de la fenêtre de détails (medium - large) $geolives_base = (!isset($geolives_basepage) || $geolives_basepage=="")?urlencode($_SERVER['REQUEST_URI']):urlencode($geolives_basepage); $geolives_nosearch=1; $geolives_page = (isset($_GET['page']))?$_GET['page']:""; $geolives_url = "http://www.sitytrail.com/tours/API?inUTF=true&context=inserted&lang=$geolives_lang&username=$geolives_user&type=$geolives_type&id=$geolives_idrando&size=$geolives_maxsize&base=$geolives_base&page=$geolives_page&country=$geolives_country&admin1=$geolives_admin1&admin2=$geolives_admin2&ville=$geolives_ville&category=$geolives_category&search=$geolives_nosearch&onlygold=$geolives_onlygold&Nville=$geolives_Nville"; $statspage = file_get_contents($geolives_url); echo(str_replace(array("\r\n", "\r", "\n"), ' ', $statspage)); ?-->

Description des paramètres¶

Paramètres de base :¶

Paramètres avancés :¶

Les paramètres ci-dessous peuvent être définis par le développeur afin de “forcer” le filtrage selon un ou plusieurs critères.

Méthodes de filtrage des paramètres avancés¶

Filtrage par script:
Le filtrage par script consiste à remplacer la définition des variables dans le script d’intégration par des valeurs “forcées”.
Exemple :
[…]
$geolives_category=3;
[…]

Filtrage par paramètres d’url:
Dans ce cas de figure, le script d’intégration est laissé tel quel et les valeurs de filtrages sont passées en paramètres à la page appelante.
Exemple :
[…]
http://www.example.com/balades.html?category=1
[…]

En savoir plus¶

L’article Requêtes avancées sur SityAPI présente les options avancées de filtrage

Api v2¶

Introduction¶

Contexte¶

SityAPI permet aux différents développeurs de consulter, d’agir sur et intégrer les données de la base SityTrail au sein de leurs propres plateformes, logiciels et infrastructures grâce a différents appels ou méthodes interagissant avec les serveurs.

La plupart des nouvelles fonctionnalités seront dorénavant intégrées en premier lieu dans l’API avant les autres parties telles que site web ou applications mobiles.

Accès aux ressources principales¶

Accès aux ressources spécifiques ¶

 ¶

 ¶

Documentation api(beta)¶

API SityTour V2¶

Accéder à la documentation de l’API V2

Accéder à la documentation de l’API V1 dépréciée

Filtrage msq¶

• Filtrage msq
  • Champ d'action
  • Utilisation 
  • Champs disponibles

Champ d'action¶

Utilisation ¶

http://api.geolives.com/VOTRE_CLEF_API/TrailManager?action=getTrails&lang=fr&msq_ville=30007&activite=1;...

Champs disponibles¶

Liste des codes pays¶

Liste des codes sport¶

Requêtes avancées sur SityAPI¶

• Requêtes avancées sur SityAPI
  • Comprendre le mécanisme de requêtes avancées
  • Liste des paramètres avancés
    • Filtrage
    • Pagination
    • Encodage
    • JQuery

Outre les méthodes d’interrogation disponibles dans le descriptif de SityAPI. Certaines requêtes d’interrogation spécifiques ont été développées afin de permettre un filtrage plus avancé des résultats.

Ces paramètres ne faisant pas l’objet d’une utilisation courante, le choix a été fait de ne pas inclure par défaut la possibilité d’interroger le serveur sur base de ces critères.

Comment accéder aux requêtes avancées ?

Afin d’activer l’utilisation de requêtes avancées sur votre compte, veuillez en demander l’activation auprès de Geolives (contact at geolives dot com)

Comprendre le mécanisme de requêtes avancées¶

La critères avancés sont définis directement lors de l’appel à l’URL du serveur SityAPI et doivent dans certains cas faire l’objet d’un traitement préalable.

Liste des paramètres avancés¶

Filtrage¶

Les paramètres ci-dessous peuvent être définis par le développeur afin de “forcer” le filtrage selon un ou plusieurs critères.

Pagination¶

Les résultats sont présentés sous forme de pages dans le but d’accélérer l’affichage et permettre une consultation plus aisée des résultats.
Le système ajoute automatiquement une barre de pagination au dessus et en dessous de la liste des résultats.
Deux paramètres peuvent être définis afin de paramétrer la pagination :

Par défaut l’API génère des pages contenant cinq résultats.

Désactiver la pagination¶

Il est possible de désactiver la pagination en spécifiant un nombre de résultats supérieur au nombre total de randonnées de l’utilisateur.
Attention : Il est déconseillé de demander un nombre supérieur à 25 randonnées par page

Encodage¶

Les résultats sont par défaut encodés en ISO-8859-1. Il est possible de définir un encodage UTF-8 en spécifiant le paramètre

inUTF=true

JQuery¶

Par défaut, les résultats contiennent un appel aux librairies JQuery. Cependant de nombreux sites intègrent déjà JQuery dans le code de base des pages.
Afin d’éviter les conflits, il est possible de désactiver l’appel aux librairies JQuery :

nojquery=true

Statuts et classement des SityGuides¶

Statut de publication ¶

Classement de SityGuides avec étoiles ¶