Today I wrote a tiny Plug-In to incorporate Dropbox Photo-Folders into a WordPress Blog.

Anbei einige 3D Fotos aus dem Wuppertaler Zoo.

Suche mit Orts- oder Stammesnamen

Nachfolgend ein Beispiel zur Suche mit der pfadis.com API:

http://pfadis.com/app/api/rest/Unit?q= schwerte&short=true

Wie unschwer zu erkennen ist, ist “q” der Suchparameter. Mit “short=true” wird ein übersichtliches Ergebnis ohne weitere Infos zu den gefundenen Stämmen/Bezirken/etc. geliefert:

{
    "result": [
        {
            "id":507,
            "url":"http:\/\/pfadis.com\/app\/api\/rest\/Unit\/507",
            "fullname":"16\/02\/04 | Stamm St. Marien (Schwerte)",
            "type":"Unit"
        }
    ],
    "page":1,
    "rpp":20,
    "total":1,
    "previous_page":null,
    "next_page":null,
    "q":"schwerte"
}

Die Suche hat genau ein Ergebnis geliefert: den Stamm St. Marien Schwerte. Gesucht werden kann nach Stammesnamen und Ortsbezeichnungen.

Suche mit geografischem Bezug

Als Suchparameter “q” eignen sich auch Ortsbezogene Angaben. So können Stämme (bzw, um genau zu sein, Stämme, denen eine Adresse zugeordnet ist) in der Nähe eines bestimmten PLZ-Bereiches gefunden werden:

http://pfadis.com/app/api/rest/Unit?q=58239&dist=10&short=true

Der Parameter “dist” gibt den Radius in Kilometern an, in dem gesucht werden soll.

{
    "result":[
        {
            "id":507,
            "url":"http:\/\/pfadis.com\/app\/api\/rest\/Unit\/507",
            "fullname":"16\/02\/04 | Stamm St. Marien (Schwerte)",
            "type":"Unit",
            "distance":0
        },
        {
            "id":514,
            "url":"http:\/\/pfadis.com\/app\/api\/rest\/Unit\/514",
            "fullname":"16\/01\/21 | Stamm Berghofen (Dortmund-Berghofen)",
            "type":"Unit",
            "distance":5.98
        },
        {
            "id":526,
            "url":"http:\/\/pfadis.com\/app\/api\/rest\/Unit\/526",
            "fullname":"16\/01\/07 | Stamm Dortmund-Soelde (Dortmund-Soelde)",
            "type":"Unit",
            "distance":6.26
        },
        {
            "id":516,
            "url":"http:\/\/pfadis.com\/app\/api\/rest\/Unit\/516",
            "fullname":"16\/01\/19 | Stamm Bonifaten 80 (Dortmund-Lichtendorf\/S\u00f6lderholz)",
            "type":"Unit",
            "distance":6.26
        },
        {
            "id":518,
            "url":"http:\/\/pfadis.com\/app\/api\/rest\/Unit\/518",
            "fullname":"16\/01\/17 | Stamm St. Ewaldi (Dortmund-Aplerbeck)",
            "type":"Unit",
            "distance":6.76
        },
        {
            "id":508,
            "url":"http:\/\/pfadis.com\/app\/api\/rest\/Unit\/508",
            "fullname":"16\/02\/03 | Stamm Hagen-Boele (Hagen-Boele\/Helfe)",
            "type":"Unit",
            "distance":7.3
        },
        {
            "id":509,
            "url":"http:\/\/pfadis.com\/app\/api\/rest\/Unit\/509",
            "fullname":"16\/02\/02 | Stamm St. Bonifatius (Hagen-Hohenlimburg)",
            "type":"Unit",
            "distance":8.24
        },
        {
            "id":522,
            "url":"http:\/\/pfadis.com\/app\/api\/rest\/Unit\/522",
            "fullname":"16\/01\/13 | Stamm Marcel Callo (Dortmund-H\u00f6rde)",
            "type":"Unit",
            "distance":8.35
        },
        {
            "id":498,
            "url":"http:\/\/pfadis.com\/app\/api\/rest\/Unit\/498",
            "fullname":"16\/02\/16 | Stamm Arche (Iserlohn)",
            "type":"Unit",
            "distance":9.06
        },
        {
            "id":506,
            "url":"http:\/\/pfadis.com\/app\/api\/rest\/Unit\/506",
            "fullname":"16\/02\/06 | Stamm St. Elisabeth (Hagen)",
            "type":"Unit",
            "distance":9.59
        }
    ],
    "page":1,
    "rpp":20,
    "total":10,
    "previous_page":null,
    "next_page":null,
    "q":"58239"
}

Der Suchparameter “q” nimmt auch zwei mit Semikolon getrennte Dezimalzahlen entgegen und interpretiert diese dann als geografischen Punkt:

http://pfadis.com/app/api/rest/Unit?q=51.4;7.6&dist=10&short=true

Konkrete Codebeispiele folgen.

Viel Spaß beim Testen – Feedback ist erwünscht.

Zum Erforschen des API empfehle ich die Verwendung von Firefox mit JSONView-AddOn. Damit lässt sich wunderbar im Browser sehen und verfolgen, welche Daten und URIs geliefert werden.

Bevor ich lange erzähle, hier ein Beispiel:

http://pfadis.com/app/api/rest/Unit

{
    result : [],
    page: 1,
    rpp: 20,
    total: 8290,
    previous_page: null,
    next_page: "http://pfadis.com/app/api/rest/Unit?page=2",
    q: null
}

Diese URL zeigt alle Units (Stämme, Bezirke, Diözesen aber auch Arbeitskreise und Stufen) an. Der obige Aufruf liefert 20 Einträge pro Seite im (oben leeren) “result” Array. Mit “previous_page” und “next_page” werden die passenden URLs zum durchforsten aller Ergebnisse mitgeliefert.

Fortsetzung “Suche mit dem REST-API”

Leider sind (noch) keine deutschen Nachschlagewerke vorgegeben. Über die Einstellungen von Glims können eigene Suchmaschinen hinzugefügt werden. Nachfolgend die Such-Urls für eine kleine Auswahl von Seiten:

• Google-DE

  http://www.google.de/search?hl=de&q=#query#

• Amazon.de

  http://www.amazon.de/s/ref=nb_ss?url=search-alias%3Daps&field-keywords=#query#

• Wikikpedia-DE

  http://de.wikipedia.org/w/index.php?search=#query#&go=Go

• dict.leo.org – Übersetzung deutsch/englisch – englisch/deutsch

  http://dict.leo.org/ende?lp=ende&lang=de&search=#query#

• Ebay-DE

  http://search.ebay.de/#query#

• Flickr-CC – Flickr Bildsuche, beschränkt auf CreativeComons-Bilder mit Freigabe

  http://www.flickr.com/search/?q=#query#&l=commderiv&ct=0&mt=all&adv=1

Diese Suchmaschinen kann man sich als Property-Datei auch gerne hier herunterladen.
Gespeichert wird diese Datei in ~/Library/Application Support/Glims

Adobe pyramid in Lima

Plants and animals of Peru

Ica, Nazcar and Maria-Reiche-Museum

Arequipa, Peru / Convent de Santa Catalina / Misti

Cañon de Colca

Tiwanacu, Bolivia

Chacaltaya mountain, Bolivia

Moon Valley, La Paz, Bolivia

Lake Titicaca, Copacabana, Uro Islands

Inca ruins and stones, Cusco, Peru

Wiñya Wayna and Inka trail

Machu Picchu in 3D

Thru some internet research I found a Kodak Easyshare M1093 IS to be the perfect camera to buy. It has 10MP, 3x optical Zoom, image stabilization, a big bright display and – best of all – it is able to record video in 720p. Furthermore I made a very good deal at our local store of Conrad electronics. I got two cameras for as little as 220,- euro.

Next step was to construct a frame to hold the two cameras. First of all I took a caliper and made a drew a raw model of the camera using the free construction tool SketchUp from Google.  I focused on the outer body and the position of the lens/blind and the position of the tripod winding relative to the body. You may downlaod the SketchUp file here.

This very simple model allowed me to arrange the cameras and to draw a frame around them. I chose an eye distance of 68mm. The next picture show a very early stage of the final SketchUp. Beforehand I bought a square-cut aluminium bar, 10×10 mm, hollow, 8×8 mm inside (cost about 2 euro per meter). So I did know what to draw, roughly.

The final sketch was more detailed and layed out with all figures to start the construction. I will make it available here as well.

After a lot of cutting, rasping, drilling, finishing etc. I ended up with this construction:

(The picture above is actually a photoshop mockup, as I had to use one camera to take the picture)

The reason why one camera is upside down is, that otherwise the eye distance would not be preserved. This makes it very difficult to construct a mechanic release. For me it works fine to press both release buttons simultaneously.

After all I got a cheap 3D camera. I spent 230,- euro (and up to 8 hours of work ).

Of course there are some lessons learned:
Tripod threads/screws are measured in inches, no chance to get a screw at the next hardware store (when you are in europe, of course)
It is quite difficult to cut the aluminium bar angled. It’s a must to use a bench vise.
It is possible to buy such frames – as I figured out later

If you made it down to here, I’m sure you are eager to know, what the results are: take a look.

I can’t wait until the 15th of July when we go public.

One thing to add: German law is so difficult and slow; it took us weeks until we are able to go public and fullfil all legal requests.