hPlace

From Microformats Wiki
Jump to navigation Jump to search

This document represents a draft microformat specification. Although drafts are somewhat mature in the development process, the stability of this document cannot be guaranteed, and implementers should be prepared to keep abreast of future developments and changes. Watch this wiki page, or follow discussions on the #microformats Freenode IRC channel to stay up-to-date.

Draft Specification 2012-03-30

Editor/Author
Flávio Oliveira

Copyright

Per the public domain release on Flávio Oliveira, this specification is released into the public domain.

Format

  • hPlace (hplace). required.
    • name (place-name). required.
    • summary (summary). optional.
    • coord (summary). required, using Geo.
    • address (address). optional, using adr.
    • type (type). optional, using rel="tag".
    • photo (photo).(permalink). optional.
    • url (url).(permalink). optional.
    • events (events).(permalink). optional, using hCalendar 1.0.


Field and Element Details

hPlace

  • A place element is identified by the class name hplace.
  • A place element should represent a geospatial place or area.
  • A place element could have a multiple sub places using nested hplace elemens.


name

  • A place name element is identified by the class name name.
  • A place name element is required.


summary

  • A place summary element is identified by the class name summary.
  • A place summary is optional.


coord

  • A place coord element is identified by the class name coord using Geo.
  • A place coord element is required.


address

  • A place address element is identified by the class name address using adr.
  • A place address element is optional.


type

  • A place type element is identified by the class name type, using rel="tag".
  • A place type element is optional.


photo

  • A place photo element is identified by the class name photo.
  • A place photo element is optional.


url

  • A place url element is identified by the class name url.
  • A place url element is optional.


events

  • A place events element is identified by the class name events.
  • A place events element is optional.


Examples

Simple Place Definition

 <div class="hplace">
    <div class="name">Castle of Mourão</div>
    <div class="summary">Here goes the place / monument description</div>
    <div class="coord geo"> GPS:<span class="latitude">38.384917</span>, <span class="longitude"> -7.345863</span></div>
    <a href="[your url]" class="url">Find More here</a>
    <a href="[your url]" rel="tag">Monuments</div>
 </div>


Nested Place Definition

 <div class="hplace">
    <div class="name">Castle of Mourão</div>
    <div class="coord geo"> GPS:<span class="latitude">38.384917</span>, <span class="longitude"> -7.345863</span></div>
    <div class="hplace">
        <div class="name">Main entrance</div>
        <div class="coord geo"> GPS:
            <span class="latitude">38.384917</span>,
            <span class="longitude"> -7.345863</span>
        </div>
    </div>
    <div class="hplace">
        <div class="name">Tower of Oliveirinha</div>
        <div class="coord geo"> GPS:
            <span class="latitude">38.384862</span>,
            <span class="longitude">-7.346662</span>
        </div>
    </div>
    <div class="hplace">
        <div class="name">Castle Church entrance</div>
        <div class="coord geo"> GPS:
            <span class="latitude">38.384597</span>,
            <span class="longitude">-7.346469</span>
        </div>
    </div>    
 </div>


Simple Place Definition with events

 <div class="hplace">
    <div class="name">Castle of Mourão</div>
    <div class="summary">Here goes the place / monument description</div>
    <div class="coord geo"> GPS:<span class="latitude">38.384917</span>, <span class="longitude"> -7.345863</span></div>
    <div class="events">
        <h3>Next available events</h3>
        <div class="vevent">
            <a href="[your url]" class="url uid summary">Bye bye summer 2012</a>
            <abbr class="dtstart" title="2012-08-30">August 30</abbr>
        </div>
        <div class="vevent">
            <a href="[your url]" class="url uid summary">Young week</a>
            <abbr class="dtstart" title="2012-08-25">August 30</abbr>
        </div>
        <div class="vevent">
            <a href="[your url]" class="url uid summary">Na. Sra. of Candeias</a>
            <abbr class="dtstart" title="2012-02-02">Feberuary 2nd</abbr>
        </div>
    </div>
 </div>