Documentation du Flux-Circuits

Exemple de requête : https://url_fournie_par_cirkwi/circuits.php?start-time=1482246813&end-time=1482246913&first=14&rows=10

Paramètres disponibles

Utilisation en GET

Nom Type Valeur par défaut Description
start-time
end-time		 timestamp NULL Permet de récupérer le détail des objets modifiés dans cet interval de temps.
first
rows 		int
int 		0
100		 Indice du premier étément de la page
Nombre de résultats souhaités par page
object-id int NULL Identifiant d'un objet spécifique à rechercher
source-object-id
source-id		 string/int
int 		NULL
NULL		 Permet de récupérer un objet à partir de son identifiant dans un SIT (Tourinsoft, Apidae, etc ...)
source-object-id : identifiant SIT
source-id : identifiant Cirkwi du SIT (fourni par nos soins)
lat
lng
rayon		 float
float
int 		NULL
NULL
NULL		 Permet de filter selon un rayon en mètres, autour d'un point géographique (latitude/longitude)
country string none Permet de filter selon un code pays. Exemples : FR, BE, DE, ES, IT, ...

Exemple de contenu du flux



    
        
          
            
            
            
              
                
                    
                    
                    
                </image>
                
                    
                </image>
              
              
                
              
              
                
                    
                    
                
              
            
            
              
                
                
              
            
            
                
                
            
            
              
            
          
          
            
            
            
              
                
                    
                    
                    
                </image>
              
            
          
        
        
        
          74
          
          
          22130
          France
          
            48.5223295900644
            -2.23556272792814
          
        
        3400
        354
        -354
        
            
            
        
        
            
            
        
        
          
          
        
        
        
          
              
                
                
              
              
                
                   
                   
                   
                      
                        
                           
                           
                        </image>
                      
                   
                   
                    
                      
                      
                    
                   
                
              
              
                1
                
                
                6970
                Belgique
                
                  48.7125946
                  6.1442926
                
                468.0
              
              
                  
                    1365123600
                    1365130800
                  
                  
                    1365123601
                    1365130802
                  
                
          
        
        
          
            
              
              
            
            
              
                
                
                
                  
                    
                        
                    </image>
                  
                
              
            
            
              1
              
              
              6970
              Belgique
              
                48.7125946
                6.1442926
              
              468.0
            
            
            
                1365123600
                1365130800
            
            
                1365123601
                1365130802
            
        
        
          
        
        
      
     
    
      
        1365123600
        1365130800
      
      
        1365123601
        1365130802

Balise POI

Cette balise contient toutes les informations pour un POI. Vous pouvez en ajouter autant que vous le voulez.

Balise Oblig. Contenu Description
poi oui - categories
- tags_prives
- informations
- adresse
- dates
- qrcodeLink
- diffusion
 Cliquez ici pour plus d'informations sur les POIs
Attributs Oblig. Contenu Description
date_modification oui temps unix Date de la dernière modification du POI
id_poi oui - Identifiant unique du POI utilisé pour les mises à jour du flux

Balise CATEGORIES (Oblig.)

Cette balise contient la ou les balises categorie

Balise Oblig. Contenu Description
categories oui - categorie
 Vous devez inserer au moins une categorie

Balise CATEGORIE (Oblig.)

Cette balise contient une catégorie correspondant à la nature de votre POI ou de votre info parcours.

Balise Oblig. Contenu Description
categorie oui Categorie (=type) de votre POI Vous devez définir au minimum une catégorie.
Attributs Oblig. Contenu Description
nom non - Ce champ a pour but de faciliter la lecture du flux car l'id de la catégorie est un entier
id_categorie oui - Identifiant de la categorie (Cliquez ici pour voir la liste des categories)

Balise INFORMATIONS (Oblig.)

Cette balise contient les balises information dans les langues disponibles

Balise Oblig. Contenu Description
informations oui - information

Balise INFORMATION (Oblig.)

Cette balise contient tout ce qui concerne le contenu (dans toutes les langues disponibles) de votre poi comme par exemple : titre, description, photos, videos, mp3,...

Balise Oblig. Contenu Description
information oui - titre
- description
- medias
- informations_complementaires
- tags_publics
- pdf_perso
 Vous devez avoir au minimum un bloc information
Attributs Oblig. Contenu Description
langue oui fr/en/it/de/nl/... Définie la langue des informations. Cliquez ici pour voir la liste des langues disponibles

Balise TITRE (Oblig.)

Balise Oblig. Contenu Description
titre oui Protégez avec un CDATA

Balise DESCRIPTION

Balise Oblig. Contenu Description
description non Protégez avec un CDATA

Balise MEDIAS

Cette balise contient les médias dans la langue définie par l'attribut langue de la balise information

Balise Oblig. Contenu Description
medias oui - images
- videos
- sons

Balise IMAGES

Cette balise contient les balises image

Balise Oblig. Contenu Description
images non - image
 Ne pas insérer s'il n'y a pas de balise url à l'intérieur

Balise VIDEOS

Cette balise contient les balises videos

Balise Oblig. Contenu Description
videos non - video
 Ne pas insérer s'il n'y a pas de balise video à l'intérieur

Balise SONS

Cette balise contient les balises sons

Balise Oblig. Contenu Description
sons non - son
 Ne pas inserer si pas de balise son à l'intérieur

Balise IMAGE

Attributs Oblig. Contenu Description
nature non entier Cliquez ici pour voir la liste des id_nature
Balise Oblig. Contenu Description
image
 non - credit
- legende
- url

Balise CREDIT

Crédit de votre média, dans la langue renseignée dans l'attribut de la balise information

Balise Oblig. Contenu Description
credit non CDATA

Balise LEGENDE

Légende de votre média, dans la langue renseignée dans l'attribut de la balise information

Balise Oblig. Contenu Description
legende non CDATA

Balise URL

URL de votre média, dans la langue renseignée dans l'attribut de la balise information

Balise Oblig. Contenu Description
url non CDATA

Balise VIDEO

Vidéo de votre circuit/POI dans la langue renseignée dans l'attribut de la balise information. Une seule vidéo par circuit ou par POI

Balise Oblig. Contenu Description
video non - credit
- code

Balise CODE

Code iframe (youtube, ...) de votre vidéo, dans la langue renseignée dans l'attribut de la balise information

Balise Oblig. Contenu Description
code non CDATA

Balise SON

MP3 de votre circuit/POI dans la langue renseignée dans l'attribut de la balise information. Un seul mp3 par circuit ou par POI

Balise Oblig. Contenu Description
son
 non - credit
- url

Balise INFORMATIONS_COMPLEMENTAIRES

Cette balise contient les balises information_complementaire

Balise Oblig. Contenu Description
informations_complementaires oui - information_complementaire

Balise INFORMATION_COMPLEMENTAIRE

Balise Oblig. Contenu Description
information_complementaire oui - titre
- description

Balise SENS_CIRCUIT

Balise Oblig. Contenu Description
sens_circuit non Définie le sens du circuit. Cliquez ici pour voir la liste des sens disponibles

Balise TAGS_PUBLICS

Balise Oblig. Contenu Description
tags_publics non - tag_public
 Vous devez insérer au moins un tag

Balise TAG_PUBLIC

Cliquez ici pour consulter la liste des tags disponibles.

Attributs Oblig. Contenu Description
id oui
nom oui

Balise PDFS_PERSO

Balise Oblig. Contenu Description
pdfs_perso non - pdf_perso

Balise PDF_PERSO

Balise Oblig. Contenu Description
pdf_perso non Url de votre PDF

Balise ADRESSE

Cette balise contient tout ce qui concerne l'adresse/la position du POI/circuit

Balise Oblig. Contenu Description
adresse oui - num
- rue
- ville
- cp
- pays
- position
- altitude

Balise NUM

Balise Oblig. Contenu Description
num non Numéro de la rue

Balise RUE

Balise Oblig. Contenu Description
rue non Protéger avec un CDATA Nom de la rue, chemin, ...

Balise VILLE

Balise Oblig. Contenu Description
ville non Nom de la ville

Balise CP

Balise Oblig. Contenu Description
cp non Code postal

Balise PAYS

Balise Oblig. Contenu Description
pays non Nom du pays
Attributs Oblig. Contenu Description
code_pays oui Code du pays : fr/en/nl/de/it/...

Balise POSITION

Balise Oblig. Contenu Description
position non - lat
- lng

Balise ALTITUDE

Balise Oblig. Contenu Description
altitude non

Balise LAT

Balise Oblig. Contenu Description
lat non Format: degrés décimaux

Balise LNG

Balise Oblig. Contenu Description
lng non Format: degrés décimaux

Balise DATES

Balise Oblig. Contenu Description
dates non - date

Balise DATE

Balise Oblig. Contenu Description
date non - date_debut
- date_fin
Attributs Oblig. Contenu Description
recursivite_annuelle non true ou false false par défaut

Balise DATE_DEBUT

Si votre POI a une date de début (festival, ...), ajoutez cette balise

Balise Oblig. Contenu Description
date_debut non temps unix

Balise DATE_FIN

Si votre POI a une date de fin (festival,...), ajoutez cette balise

Balise Oblig. Contenu Description
date_fin non temps unix

Balise RECURSIVITE_ANNUELLE

Balise Oblig. Contenu Description
recursivite_annuelle non booléen true ou false

Balise POIS

Cette balise contient les différentes pois.

Balise Oblig. Contenu Description
pois non - poi
 Vous devez insérer au moins un poi

Balise CIRCUITS

Cette balise contient tous les circuits. Vous pouvez en ajouter autant que vous le voulez.

Balise Oblig. Contenu Description
circuits oui - circuit
 Vous devez insérer au moins un circuit.

Balise CIRCUIT

Cette balise contient toutes les informations concernant un circuit. Vous pouvez en ajouter autant que vous le voulez.

Balise Oblig. Contenu Description
circuit non - informations
- adresse
- distance
- tags
- locomotions
- fichier_trace
- infos_parcours
- pois
- qrcodeLink
- diffusion
Attributs Oblig. Contenu Description
date_creation non Date de la création du circuit.
date_modification oui Date de modification du circuit.
id_circuit oui ID du circuit.
id_utilisateur non ID de l'utilisateur.

Balise DISTANCE

Cette balise contient une distance en mètres.

Balise Oblig. Contenu Description
distance non en mètres

Balise TAGS_PRIVES

Cette balise contient la ou les balises tag_prive

Balise Oblig. Contenu Description
tags_prives non - tag_prive
 Vous devez insérer au moins un tag.

Balise TAG_PRIVE

Cette balise contient un tag privé. Il ne dépend pas d'une langue. Si vous souhaitez ajouter des tags privés, contactez-nous.

Attributs Oblig. Contenu Description
id non
nom oui

Balise LOCOMOTIONS

Cette balise contient les différents type de locomotions. Vous pouvez en ajouter autant que vous le voulez.

Balise Oblig. Contenu Description
locomotions non - locomotion
 Vous devez insérer au moins un moyen de locomotion.

Balise LOCOMOTION

Cette balise contient le moyen de locomotion. Cliquez ici pour voir la liste des moyens de locomotion disponibles.

Attributs Oblig. Contenu Description
type non Type de locomotion.
id_locomotion oui ID du moyen de locomotion
difficulte non Entier entre 1 et 8 Difficulté de la locomotion
duree non Durée en secondes pour ce moyen de locomotion
jours non Nombre de jours pour ce moyen de locomotion

Balise FICHIER_TRACE

Cette balise contient le fichier_trace.

Attributs Oblig. Contenu Description
url non url du fichier GPX, KML ou KMZ
infos_parcours non true ou false Si vous souhaitez que nous importions les points du fichier en tant qu'info parcours, renseignez true

Balise INFOS_PARCOURS

Cette balise contient les différentes infos parcours.

Balise Oblig. Contenu Description
infos_parcours non - info_parcours

Balise INFO_PARCOURS

Cette balise contient les informations concernant l'info parcours.

Attribut Oblig. Contenu Description
numero non Numéro de l'info parcours.
date_modification non temps unix
id_info_parcours oui
Balise Oblig. Contenu Description
info_parcours non - categories
- informations
- adresse
- dates

Balise QRCODELINK

Cette balise contient le lien universel de l'objet.

Balise Oblig. Contenu Description
qrcodeLink non Lien universel renvoyant vers l'application lorsqu'elle est installée sur l'appareil.

Balise DIFFUSION

Cette balise contient les informations de diffusion de l'objet.

Attributs Oblig. Contenu Description
cirkwi non entier 1 (recommandé): la diffusion sur la plateforme Cirkwi.com est activée.
0 : la diffusion est désactivée.
mobile non entier
0 ou 1		 1 (recommandé): la diffusion sur les applications mobile est activée.
0 : la diffusion est désactivée.
reseau non entier
0 ou 1		 1 (recommandé): la diffusion sur le réseau de diffusion de partenaires Cirkwi est activée (l'offre profite d'une promotion sur de nombreux sites web).
0 : la diffusion est désactivée.
partage non entier
0, 1 ou 2		 Uniquement pour les POIs
2 (recommandé) : Partage avec tout le monde. L'objet peut être lié à d'autres objets mais vous en restez propriétaire et gestionnaire. Cela évite simplement que d'autres auteurs créent des doublons.
1 : partage uniquement avec vous-même. Vous pouvez lier cet objets à d'autres objets de votre propre compte uniquement.
0 : l'objet n'est pas réutilisable.

Balise AUTEUR

Cette balise contient les informations sur l'auteur de la donnée.

Balise Oblig. Contenu Description
auteur non string Nom protégé par un CDATA
Attribut Oblig. Contenu Description
id_utilisateur oui int L'id utilisateur de l'auteur. Cliquez ici pour trouver votre id utilisateur.

Balise DDRS

Cette balise contient la liste des données de référence.

Balise Oblig. Contenu Description
ddrs non - ddr Liste des données de référence.

Balise DDR

Balise Oblig. Contenu Description
ddr non
Attribut Oblig. Contenu Description
id_ddr oui int Identifiant de la donnée de référence. Cette information se trouve dans votre compte IGNrando'.