pull/149/head
Dave Jones 2020-12-23 14:57:00 -06:00
rodzic 2befa847fe
commit 2aac9c53ba
1 zmienionych plików z 11 dodań i 13 usunięć

Wyświetl plik

@ -17,7 +17,7 @@ Below, you will find implementation details and UX recommendations for the `<pod
The maximum recommended string length of all attribute values is 128 characters.
<br>
<br><br>
This tag is intended to describe the location of editorial focus for a podcast's content - i.e. "what place is this podcast about?" It can exist at either the channel level or the item level, or both.
@ -30,9 +30,6 @@ The use-cases for this tag are multiple, in order of complexity:
4. To describe a specific place in a programmatic fashion to allow complex geo-aware searches
<br>
It may allow very complex searches such as:
- Show me podcasts or episodes about places near me
@ -48,6 +45,7 @@ or a restaurant within a city. "Locations" are also, not always real places, esp
This, therefore, means that the podcast:location tag is complex and has a number of attributes.
<br>
### Structure
@ -59,23 +57,23 @@ This, therefore, means that the podcast:location tag is complex and has a number
>
```
**mandatory**: `name="[Humanly readable name]"` - this is meant for podcast apps to display the name of the location that the podcast is about. Examples might be "Houses of Parliament", "Gitmo Nation" or
- **mandatory**: `name="[Humanly readable name]"` - this is meant for podcast apps to display the name of the location that the podcast is about. Examples might be "Houses of Parliament", "Gitmo Nation" or
"Ernest Murrow Theater, Chicago"). This is not intended to be programmatically parsed and is for display only. For a programmatic designation of the location, use OSM IDs, below.
This field is a maximum of 64 characters. It may describe a real or fictional place. It should be in the same language as the podcast, as indicated in the <language> RSS tag: so a podcast in en should
read Eiffel Tower, Paris and not La Tour d'Eiffel.
**recommended**: `geo="[geoURI]"` - a geo URI, conformant to [RFC 5870](https://tools.ietf.org/html/rfc5870). Examples:
- **recommended**: `geo="[geoURI]"` - a geo URI, conformant to [RFC 5870](https://tools.ietf.org/html/rfc5870). Examples:
- geo:37.786971,-122.399677 (a simple latlon description)
- geo:37.786971,-122.399677,250 (a latlon including a height of 250 meters above ground level)
- geo:37.786971,-122.399677;u=350 (a latlon with an accuracy ('uncertainty') of 350 meters).
- For information that may interest space travellers: the RFC does include an optional coordinate reference system for other planets, though these are not recommended to be used yet by the RFC.
- geo:37.786971,-122.399677 (a simple latlon description)
- geo:37.786971,-122.399677,250 (a latlon including a height of 250 meters above ground level)
- geo:37.786971,-122.399677;u=350 (a latlon with an accuracy ('uncertainty') of 350 meters).
- For information that may interest space travellers: the RFC does include an optional coordinate reference system for other planets, though these are not recommended to be used yet by the RFC.
`geo` is recommended to be used alongside an OSMID. Since OSM IDs are not guaranteed to be permanent (perhaps it's the ID of a building which is later demolished), the geoURI serves as a permanent point.
Exceptions are podcasts from, or about, fictional places. Data within these tags must relate to a real place.
**recommended**: `osmid="[OSM type][OSM id]"` - from an OpenStreetMap query. If a value is given for osmid it must contain both 'type' and 'id'. osm type: A one-character description of the type of OSM point.
- **recommended**: `osmid="[OSM type][OSM id]"` - from an OpenStreetMap query. If a value is given for osmid it must contain both 'type' and 'id'. osm type: A one-character description of the type of OSM point.
Valid is "N" (node); "W" (way); "R" (relation). osm id: The ID of the OpenStreetMap feature that is described.
This may describe part of a building, a building or business, a suburb, city, state, or country - anything within the OSM database, using the OpenStreetMap API or a local copy of the data. This is the field
@ -83,8 +81,8 @@ that is the best programmatic representation of the place being described. The d
Examples:
- The United States of America: [R148838](https://nominatim.openstreetmap.org/ui/details.html?osmtype=R&osmid=148838)
- The Eiffel Tower in Paris: [W5013364](https://nominatim.openstreetmap.org/ui/details.html?osmtype=W&osmid=5013364)
- The United States of America: [R148838](https://nominatim.openstreetmap.org/ui/details.html?osmtype=R&osmid=148838)
- The Eiffel Tower in Paris: [W5013364](https://nominatim.openstreetmap.org/ui/details.html?osmtype=W&osmid=5013364)
The `osmid` is recommended to be used alongside a geo tag. Since OSM IDs are not guaranteed to be permanent (perhaps it's the ID of a building which is later demolished), the geoURI serves as a permanent
point. Exceptions are podcasts from, or about, fictional places. Data within these tags must relate to a real place.