Documentation du Flux-Pois

Exemple de requête : https://url_fournie_par_cirkwi/pois.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

Balise POIS (Oblig.)

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

Balise	Oblig.	Contenu	Description
pois	oui	- poi
Attributs	Oblig.	Contenu	Description
version	oui	Renseignez "2"	Version de notre modèle de flux actuel

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
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
id_utilisateur	non	-	Si votre flux comporte des POIs appartenant à des utilisateurs différents, renseignez ce champ avec un identifiant unique par utilisateur. Veuillez nous contacter pour créer une table de liaison entre vos identifiants utilisateur et les nôtres
id_source	non	-	Si jamais un flux a plusieurs sources, comme pour id_utilisateur, nous pouvons le différencier lors de l'importation

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.

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 étant donné que 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 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 INFORMATIONS

Cette balise contient les balises information dans les langues disponibles

Balise	Oblig.	Contenu	Description
informations	oui	- information

Balise INFORMATION

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	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 ADRESSE

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

Balise	Oblig.	Contenu	Description
adresse	non	- 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		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	non		Code du pays : fr/en/nl/de/it/...

Balise POSITION (Oblig.)

Balise	Oblig.	Contenu	Description
position	oui	- lat - lng

Balise ALTITUDE

Balise	Oblig.	Contenu	Description
altitude	non

Balise LAT (Oblig.)

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

Balise LNG (Oblig.)

Balise	Oblig.	Contenu	Description
lng	oui	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 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	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'.