Die Syntax ist mal denkbar einfach, denn das ganze beschränkt sich auf eine einzige Methode, nämlich:

yqlgeo.get(what,callback)

Damit geht neben dem Verorten von Strings à la GooglemapsAPI:

yqlgeo.get('cologne, DE',function(o){
  alert(o.place.name+' ('+
  o.place.centroid.latitude+','+
  o.place.centroid.longitude+
')');
})

…auch mal eben Verorten von IPs:

yqlgeo.get('217.12.14.240',function(o){
  alert(o.place.name + ',' + o.place.country.content +
    ' (' + o.place.centroid.latitude + ',' +
    o.place.centroid.longitude + ')'
  );
});

…Usern, URLS und verlorengegangenen Schlüsseln.

Cooles Ding – Lohnt sich definitiv mal anzuschauen!