IPTC News in JSON and Sports in JSON

News in JSON

Stuart Myles * Associated Press * 16th June 2014

http://www.flickr.com/photos/26226551@N00/10753739865/

http://www.flickr.com/photos/26226551@N00/10753739865/

Remind Me: What is JSON?JSON = JavaScript Object Notation http://json.org/

Name / value pairs: a fieldname in quotes, a colon, a value in quotes

"givenname" : "Evan"

Objects: written inside curly braces, may contain multiple NVPs

{"givenname" : "Evan", "familyname" : "Sandhaus"}

Arrays: Written inside square braces, may contain multiple objects{"iptcdelegates": [ { "givenname": "Jayson", "familyname": “Lorenzen"}, { "givenname": "Jeremy", "familyname": "Brooks"}, { "givenname": "Evan", "familyname": "Sandhaus" }]}

© 2014 IPTC (www.iptc.org) All rights reserved 2

http://json.org/

http://json.org/

Remind Me: Why News in JSON?

Lightweight, easy to parse format

Increasingly popular alternative to / replacement for XML

Two principle use cases:

data interchange (e.g. APIs) with an emphasis on partial representation

data at rest (e.g. search engines like Elastic Search or MongoDB)

Not simply translating from any existing XML standard into JSON

Determine how to represent key properties and structures

Hand crafted, rather than mechanically translating from XML into JSON

Goal: comprehensive standard, lightweight instance documents


ninjs Overview


http://groups.yahoo.com/neo/groups/iptc-news-in-json-dev

ninjs Data Model


http://dev.iptc.org/ninjs

ninjs 1.1

• ninjs is a JSON representation of a news item– Text, Photo, Graphic, Video, Audio, Package

• You can represent a complete item, with all properties– For instance in an internal CMS like MongoDB

• Or you may want to convey key properties– For instance as an API response

• The representationtype property indicates how complete– Either “full” or “partial”

• Associations are themselves ninjs documents– You may include complete or partial representations


A Complete NINJS 1.1 Article

{ "uri" : "http://ninjs.example.com/newsitems/20130709simp123", "type" : "text", "versioncreated" : "2013-07-09T10:37:00Z", "byline" : "Paulo Santalucia and Frances d'Emilio", "headline" : "Captain of wrecked cruise ship on trial in Italy", "body_text" : "GROSSETO, Italy (EP) -- The trial of the captain of the shipwrecked Costa Concordia cruise liner has begun in a theater converted into a courtroom …"}


http://ninjs.example.com/newsitems/20130709simp123



ninjs Resources

• The ninjs development website is a trove of information http://dev.iptc.org/ninjs

• ninjs JSON schema http://www.iptc.org/std/ninjs/ninjs-schema_1.1.json• Uses JSON schema draft standard http://json-schema.org/

– Validation http://dev.iptc.org/ninjs-Validation-of-ninjs-Objects

• ninjs examples– Text http://dev.iptc.org/ninjs-Examples-1– Photo http://dev.iptc.org/ninjs-Examples-2– Multimedia http://dev.iptc.org/ninjs-Examples-3

• Best practices and how tos http://dev.iptc.org/ninjs-Best-Practices-and-How-Tos

• ninjs github https://github.com/iptc/newsinjson• ninjs feedback forum http://dev.iptc.org/Forum-5

and mail list [email protected]





http://www.iptc.org/std/ninjs/ninjs-schema_1.1.json

http://www.iptc.org/std/ninjs/ninjs-schema_1.1.json

http://json-schema.org/



http://dev.iptc.org/ninjs-Validation-of-ninjs-Objects

http://dev.iptc.org/ninjs-Examples-1









http://dev.iptc.org/ninjs-Best-Practices-and-How-Tos



https://github.com/iptc/newsinjson

https://github.com/iptc/newsinjson

http://dev.iptc.org/Forum-5

http://dev.iptc.org/Forum-5

mailto:[email protected]

Sports in JSON

• Develop a standard JSON representation of sports data• Working with the SportsML group• Decided to manage the work in News in JSON list

– [email protected]

• Joint working phone calls

• Initial progress– Established design principles, based on ninjs experience– Drafted an initial set of 30 to 40 properties– Represent a sports event within a competition



Sports in JSON Experiments

• Early experiment to represent a sports event in JSON

• Using "flattened" team and player structures– https://gist.github.com/stuartmyles/ba2250e3b1703045f7ac

• Using players "inside" teams– https://gist.github.com/stuartmyles/b47771cd614b675bd8e0


https://gist.github.com/stuartmyles/ba2250e3b1703045f7ac



https://gist.github.com/stuartmyles/b47771cd614b675bd8e0

https://gist.github.com/stuartmyles/b47771cd614b675bd8e0

Sports in JSON Experiments

• Our preliminary conclusion is that players “inside” teams is best

• But the key is that it is important to construct alternatives and evaluate them using experimental code

• Update on progress in Frankfurt• Participate via [email protected]



IPTC News in JSON and Sports in JSON

Technology

Transcript of IPTC News in JSON and Sports in JSON