XML-Schnittstelle: Unterschied zwischen den Versionen

(wird erstellt)
 
(XML-Schnittstelle in Vergangenheitsform gesetzt)
 
(12 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{In Arbeit|following}}
Die '''XML-Schnittstelle''' von Opencaching.de ermöglichte es bis Mitte 2020<ref>[https://github.com/OpencachingDeutschland/oc-server3/commit/e02ca45d606fd752c3d7179f2dcca275316b1a3c Commit vom 12.01.2020 zum Entfernen der Schnittstelle]. Diese Änderungen wurden erst im Juni 2020 mit der Einführung des Cookie Consent Tools auch auf der Webseite wirksam.</ref>, Cachelistings, Logs und Bilder herunterzuladen, zum Beispiel
 
* einzelne Caches
* Caches in einem bestimmten Umkreis
* neue und veränderte Daten seit einem bestimmten Zeitpunkt
* die gesamte Opencaching-Datenbank.
 
Die Daten wurden in einem XML-Format übertragen und waren nicht zum direkten Lesen, sondern zur Weiterverarbeitung durch Programme/Apps/Tools gedacht. Ihre Verwendung unterliegt der [[Datenlizenz]].
 
[[API-Clients#XML-Clients|Diese Programme]] (unvollständige Liste) nutzen die XML-Schnittstelle.
 
Mit der [[Opencaching-API]] (OKAPI) ist eine weitere, komfortablere Schnittstelle verfügbar, die auch das Hochladen von Logs ermöglicht.
 
== XML-Schnittstelle vs. OKAPI ==
 
Die OKAPI ist flexibler einsetzbar, besser dokumentiert, bietet mehr Funktionen und die bessere Performance, wird konsequenter weiterentwickelt und ist auch auf anderen [[Opencaching]]-Länderseiten verfügbar. Sie ist daher die erste Wahl für die meisten Anwendungen.
 
Die Vorteile des XML-Interfaces lagen vor allem im Abruf großer Datenmengen. Wenn man z.B. die Koordinaten, Typen, Namen etc. aller Caches für eine Kartendarstellung braucht, müsste man dazu mit der OKAPI die komplette Datenbank inklusive aller Cachebeschreibungen und Logs ziehen; außerdem muss man neue Daten mindestens einmal pro Woche abrufen. Beim XML-Interface konnte man dagegen gezielt nur die Basisdaten aller Caches abrufen, und es gab keine Mindestfrequenz für Aktualisierungen.
 
Alle anderen OKAPI-Abrufe, bei denen man nicht die gesamte Datenbank herunterlädt, sind auf 500 Caches pro Abruf beschränkt. Beim XML-Interface gab es keine Beschränkung.
 
== Weblinks ==
 
* [http://www.opencaching.de/doc/xml Beschreibung der XML-Schnittstelle] ([https://github.com/OpencachingDeutschland/oc-server3/tree/development/htdocs/doc/xml Auf GitHub] bzw. [https://github.com/OpencachingDeutschland/oc-server3/blob/5f2bc06c3fc8ed41542a3a8deeb3a71cb99fc69b/htdocs/doc/xml/ Permalink])
* [https://github.com/OpencachingDeutschland/oc-server3/tree/development/local/ocxml11client Client-Referenzimplementierung] ([https://github.com/OpencachingDeutschland/oc-server3/blob/5f2bc06c3fc8ed41542a3a8deeb3a71cb99fc69b/local/ocxml11client/ Permalink])
 
== Referenzen ==
 
<references />
 
 
[[Kategorie:Opencaching]]
[[Kategorie:Geocaching-Software]]

Aktuelle Version vom 13. Mai 2024, 17:31 Uhr

Die XML-Schnittstelle von Opencaching.de ermöglichte es bis Mitte 2020[1], Cachelistings, Logs und Bilder herunterzuladen, zum Beispiel

  • einzelne Caches
  • Caches in einem bestimmten Umkreis
  • neue und veränderte Daten seit einem bestimmten Zeitpunkt
  • die gesamte Opencaching-Datenbank.

Die Daten wurden in einem XML-Format übertragen und waren nicht zum direkten Lesen, sondern zur Weiterverarbeitung durch Programme/Apps/Tools gedacht. Ihre Verwendung unterliegt der Datenlizenz.

Diese Programme (unvollständige Liste) nutzen die XML-Schnittstelle.

Mit der Opencaching-API (OKAPI) ist eine weitere, komfortablere Schnittstelle verfügbar, die auch das Hochladen von Logs ermöglicht.

XML-Schnittstelle vs. OKAPI

Die OKAPI ist flexibler einsetzbar, besser dokumentiert, bietet mehr Funktionen und die bessere Performance, wird konsequenter weiterentwickelt und ist auch auf anderen Opencaching-Länderseiten verfügbar. Sie ist daher die erste Wahl für die meisten Anwendungen.

Die Vorteile des XML-Interfaces lagen vor allem im Abruf großer Datenmengen. Wenn man z.B. die Koordinaten, Typen, Namen etc. aller Caches für eine Kartendarstellung braucht, müsste man dazu mit der OKAPI die komplette Datenbank inklusive aller Cachebeschreibungen und Logs ziehen; außerdem muss man neue Daten mindestens einmal pro Woche abrufen. Beim XML-Interface konnte man dagegen gezielt nur die Basisdaten aller Caches abrufen, und es gab keine Mindestfrequenz für Aktualisierungen.

Alle anderen OKAPI-Abrufe, bei denen man nicht die gesamte Datenbank herunterlädt, sind auf 500 Caches pro Abruf beschränkt. Beim XML-Interface gab es keine Beschränkung.

Weblinks

Referenzen

  1. Commit vom 12.01.2020 zum Entfernen der Schnittstelle. Diese Änderungen wurden erst im Juni 2020 mit der Einführung des Cookie Consent Tools auch auf der Webseite wirksam.