h-geo
Tantek Çelik (Editor) Christophe Ducamp (Traduction)
h-geo est un format simple, ouvert pour publier des coordonnées géographiques WGS84. h-geo est l'un des nombreux standards microformat ouverts draft destiné à embarquer de la data en HTML/HTML5.
h-geo est la mise à jour microformats2 de geo. Il est le plus communément utilisé comme partie d'une h-card ou d'un h-event.
Exemple
Voici un exemple simple de h-geo :
<p class="h-geo">
<span class="p-latitude">-27.116667</span>,
<span class="p-longitude">-109.366667</span>
</p>
Pour démarrer
La classe h-geo
est un nom de classe racine qui indique la présence d'un h-geo.
Les noms de classes p-latitude, p-longitude et p-altitude définissent un élément comem une propriété du h-geo.
Voir microformats2-parsing pour en savoir plus sur les noms de classes propriété.
Propriétés
Les propriétés h-geo, dans un élément avec la classe h-geo:
p-latitude
- latitude décimalep-longitude
- longitude décimalep-altitude
- altitude décimale
Toutes les propriétés sont optionnelles.
Statut
h-geo est une spécification microformats draft. La discussion publique sur hgeo a lieu sur h-geo-feedback, le canal irc #microformats sur irc.freenode.net, et la liste de discussion microformats-new.
h-geo est prêt pour l'usage et implémenté dans la jungle, mais pour des raisons de compatibilité arrière vous devriez aussi marquer et enrichir les h-geos avec les noms de classes classiques geo.
Détails des propriétés
p-altitude fait référence à la distance en mètres à partir du niveau nominal de la mer le long de la tangente de la courbe de la terre. Pour plus d'information, voir la spécification WGS84.
FAQ
Comment devrais-je marquer les coordonnées lat/long sans qu'elles ne portent à confusion ?
À moins que votre contenu ne soit ciblé sur un public expert, publier p-latitude et p-longitude sous forme de nombres sur une page web peut ne pas être la meilleure approche. En outre, il peut se poser des problèmes d'accessibilité du fait des longues chaînes de nombres à lire.
Vous pourriez présenter les coordonnées dans un format plus lisible par les humains, en ne retenant que les coordonnées décimales dans les attributs de valeurs de la data :
<p class="h-geo">
<data class="p-longitude" value="-27.116667">27° 7′ 0″ S</data>,
<data class="p-latitude" value="-109.366667">109° 22′ 0″ W</data>
</p>
Alternativement, vous pourriez ne pas afficher les coordonnées et ne présenter qu'une représentation lisible par les humains de l'endroit, avec les lat/long dans les valeurs d'attributs d'éléments de data vide.
Exemples dans la Jungle
- … ajouter ici tout exemple h-geo dans la jungle.
Validation
Testez et validez votre marquage avec :
- http://waterpigs.co.uk/php-mf2/ - entrez directement votre marquage
- http://pin13.net/ - entrez une URL vers une page à tester là où cela dit "Microformats Parser"
Rétro-Compatibilité
Compatibilité d'Auteur
Pour une rétro-compatibilité, vous pourriez désirer utiliser les noms de classes classiques geo en plus des propriétés h-geo, par exemple :
<p class="h-geo geo">
<span class="p-latitude latitude">-27.116667</span>,
<span class="p-longitude longitude">-109.366667</span>
</p>
Compatibilité Parseur
Les parseurs microformats devraient détecter les propriétés classiques et les parser comme des propriétés microformats2. Si un "h-geo" est trouvé, ne pas chercher un "geo" sur le même élément.
Compatibilité nom de classe racine : geo
Propriétés : (parsées en plein-texte à moins qu'autre chose ne soit spécifié)
- latitude
- longitude
Historique
h-geo est basé sur le standard WGS84, tout comme la spécification existante geo, qui a été extraite de hCard afin de lui permettre d'être utilisé pour des applications autres que l'information de contact.
Voir aussi
- microformats2
- h-card et h-event contiennent souvent h-geo
- h-adr est utilisé pour marquer des adresses structurées lisibles par les humains.