kopia lustrzana https://github.com/Podcastindex-org/podcast-namespace
cleanup
rodzic
2befa847fe
commit
2aac9c53ba
|
@ -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.
|
||||
|
|
Ładowanie…
Reference in New Issue