Google Data APIs Protocol

Google Data APIs Protocol - interesting move from Google. I (and others) have thought for a while that combining OpenSearch’s read capabilities with the Atom Publishing Protocol’s write capabilities would create a very powerful API, and that’s roughly what Google is doing here.

It’s great to see the OpenSearch support (a bit - they’re using startIndex, totalResults and itemsPerPage), but I’d like to see them using it more. Some of what they’re doing is contrary to how OpenSearch works (that’s not a problem per-say), as they’re using predefined query names such as q and max-results (and a folder for categories) rather that allowing people to use whichever they want and then specify them in an OpenSearch Description file.

In that same vein, it would be nice to see them make use of autodiscovery, as Atom, RSS, OpenSearch, and others do. Upon first inspection I would say these autodiscovered documents could be OpenSearch Descriptions, but I may be wrong about that.

One interesting thing to note is that they mention how startIndex is 1-based (which is true), and then display an example with a value of “0″. Sounds like DeWitt is right, it does need to handle 0-based numbers too; even Google is making that mistake.

DeWitt brings up some other good points as well.

Via Niall.

Update: Joe Gregorio weighs in

Update 2: Marc Canter (one of my favourite bloggers) finds this linkworthy ;-) although I’m always amazed at the spellings my name gets.

tall trees; narrow path

This is the only photo in this set that I modified before posting. I increased the brightness a fair bit, and the contrast a little.

I like the sort of perspective it shows. All the Presidio trees seemd quite tall.

0187modified
17-Apr-05 18:16:26

looking towards the tree-tops

I’ve taken more than one photo that looks a lot like this. But I like it.

0173
17-Apr-05 18:13:41

tree-climbing vines

Quite a lot of the trees were very covered in these leafy vines.

0167
17-Apr-05 18:12:01

looking from the trail to the golf course

Just a little off of the trail and you can see the golf course just to the south of it.

0162
17-Apr-05 18:10:39

bowed trees

0155
17-Apr-05 18:08:03

Bay Area Ridge Trail

This photo is from shortly after I left the road (Washington Boulevard) and went onto the trail. You can see it on this map; the exact location of the photo is roughly between the north part of the Presidio Golf Course and the Amatory Loop.

0149
17-Apr-05 18:06:20