Opencaching-API: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Link zum Forum aktualisiert
Flopp (Diskussion | Beiträge) (Link zur Client-Übersicht hinzugefügt) |
(Link zum Forum aktualisiert) |
||
| (13 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt) | |||
| Zeile 5: | Zeile 5: | ||
Die OKAPI ist bei den [[Opencaching|Opencaching-Länderseiten]] in Deutschland/Italien/Spanien, Polen, den USA, Großbritannien und den Niederlanden verfügbar. Auf Opencaching.de kann alternativ auch die weniger leistungsfähige [[XML-Schnittstelle]] genutzt werden. | Die OKAPI ist bei den [[Opencaching|Opencaching-Länderseiten]] in Deutschland/Italien/Spanien, Polen, den USA, Großbritannien und den Niederlanden verfügbar. Auf Opencaching.de kann alternativ auch die weniger leistungsfähige [[XML-Schnittstelle]] genutzt werden. | ||
Es gibt bereits einige [[OKAPI-Clients]]. | Es gibt bereits einige [[OKAPI-Clients]] für Opencaching.de. | ||
== Funktionsweise == | == Funktionsweise == | ||
Die OKAPI stellt verschiedene Webservices zur Verfügung, die Daten wahlweise im [http://www.json.org/ JSON]- oder XML-Format liefern. Außerdem ist der Download von Cachedaten im [[GPX-Datei|GPX-Format]] möglich. Eine Beschreibung aller angebotenen Funktionen gibt es auf '''[http://www.opencaching.de/okapi/ opencaching.de/okapi]'''. | Die OKAPI stellt verschiedene Webservices zur Verfügung, die Daten wahlweise im [http://www.json.org/ JSON]- oder XML-Format liefern. Außerdem ist der Download von Cachedaten im [[GPX-Datei|GPX-Format]] möglich. Eine Beschreibung aller angebotenen Funktionen gibt es auf '''[http://www.opencaching.de/okapi/ opencaching.de/okapi]'''. | ||
== Zugriff auf das Benutzerkonto == | |||
Wenn eine OKAPI-Anwendung deine Funde oder Nichtfunde anzeigen, auf deine [[Caches beobachten|Beobachtungs-]] oder [[Caches ignorieren|Ignorierliste]] zugreifen soll oder Caches [[Das Onlinelog|loggen]] soll, musst du ihr Zugriff auf dein [[Benutzerprofil|Benutzerkonto]] gewähren. Dies geht halbautomatisch innerhalb der Anwendung: Du wirst bei Bedarf gefragt, ob du den Zugriff gewähren möchtest. | |||
Mit dem Menüpunkt [http://www.opencaching.de/okapi/apps/ API-Anwendung] unter „Mein Profil“ kannst du sehen, welchen Anwendungen du Zugriff gegeben hast, und kannst dies jeweils widerrufen. | |||
== Entwicklung == | == Entwicklung == | ||
Die OKAPI wurde vom dem polnischen Geocacher Wojciech Rygielski ([http://forum. | Die OKAPI wurde vom dem polnischen Geocacher Wojciech Rygielski ([http://forum.opencaching.de/index.php?action=profile;u=410 Wrygiel]) entwickelt, der auch für die Weiterführung des Projekts verantwortlich ist. Die Entwicklung wird zentral auf [http://code.google.com/p/opencaching-api/ Google Code] koordiniert; von dort werden Code-Updates auf die einzelnen Länderseiten verteilt. | ||
Die OKAPI-Entwicklung ist offen für jeden, der etwas beitragen möchte. Wenn bestimmte Features für eine Anwendung fehlen kann man also versuchen, sie selbst einzubauen. | |||
== Einschränkungen == | == Einschränkungen == | ||
Gegenüber der üblichen Opencaching.de-Funktionalität hat die OKAPI einige Einschränkungen: | Gegenüber der üblichen Opencaching.de-Funktionalität hat die OKAPI einige Einschränkungen: | ||
* es können keine Logbilder hochgeladen werden | * es können keine Logbilder hochgeladen werden | ||
* es können keine Status(änderungen) geloggt werden | |||
* gesperrte Caches können nicht abgerufen werden ([http://code.google.com/p/opencaching-api/issues/detail?id=123 Info]) | * gesperrte Caches können nicht abgerufen werden ([http://code.google.com/p/opencaching-api/issues/detail?id=123 Info]) | ||
* gespeicherte Suchen aus dem Benutzerprofil sind nicht nutzbar | * gespeicherte Suchen aus dem Benutzerprofil sind nicht nutzbar | ||
== Anpassung bestehender OKAPI-Clients an Opencaching.de == | == Anpassung bestehender OKAPI-Clients an Opencaching.de == | ||
| Zeile 32: | Zeile 38: | ||
* Drive-In | * Drive-In | ||
* Other | * Other | ||
Der Typ Math/Physics wird wahrscheinlich nicht mehr lange verwendet und | Der Typ Math/Physics wird wahrscheinlich nicht mehr lange verwendet und kann als "Quiz" dargestellt werden. | ||
''Achtung:'' Suchabfragen nach diesen Cachetypen auf anderen OC-Seiten als Opencaching.de/.it/.es führen zu einer OKAPI-Fehlermeldung. Bei der Suche muss also die gewählte OC-Seite mit berücksichtigt werden. | |||
=== Logtext-Format === | === Logtext-Format === | ||
| Zeile 63: | Zeile 71: | ||
* das [[Vorschaubilder|Vorschaubild]] eines Caches ist abrufbar | * das [[Vorschaubilder|Vorschaubild]] eines Caches ist abrufbar | ||
* die neue GPX-Option "images=descrefs:thumblinks" bettet verlinkte Thumbnail-Bilder in GPX-Daten ein | * die neue GPX-Option "images=descrefs:thumblinks" bettet verlinkte Thumbnail-Bilder in GPX-Daten ein | ||
* GC-Codes von [[Mehrfachlisting]]s sind abfragbar | |||
* Es wurden globale, mit eigenen IDs („A-Codes“) identifizierte Attribute eingeführt. | |||
* [[Schutzgebiete]], in denen Geocaches sich wahrscheinlich befinden, sind abfragbar | |||
[[Kategorie:Geocaching-Software]] | [[Kategorie:Geocaching-Software]] | ||