place-brainstorming

From Microformats Wiki
Revision as of 09:59, 31 March 2012 by Tantek (talk | contribs) (removed premature name-selection, draft-state, noted quick summary of prerequisites yet to be met)
Jump to navigation Jump to search

<entry-title>place-brainstorming</entry-title>

This page is currently a premature (lack of process) brainstorming proposal for marking up named places.

At a minimum, per process there needs first to be:

  • attempt to re-use existing microformats first
    • which should quickly reveal that hCard is likely sufficient for named places
  • if not, documentation of real world places-examples and use-cases that require more than what hCard provides
  • documentation of previous places-formats attempts

Summary: use hCard to markup named places. Document any real world use-cases and pages that require anything more in places-examples

- Tantek 09:59, 31 March 2012 (UTC)

place proposal 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.


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

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