XML-Schnittstelle: Unterschied zwischen den Versionen

Aus Opencaching-Wiki
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
(Schnittstelle ist mittlerweile nicht mehr verfügbar)
 
(7 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Die '''XML-Schnittstelle''' von Opencaching.de ermöglicht es, Cachelistings, Logs und Bilder herunterzuladen, zum Beispiel  
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
* einzelne Caches
Zeile 6: Zeile 6:
* die gesamte Opencaching-Datenbank.
* die gesamte Opencaching-Datenbank.


Die Daten werden in einem XML-Format übertragen und sind nicht zum direkten Lesen, sondern zur Weiterverarbeitung durch Programme / Apps / Tools gedacht. Sie dürfen <u>nicht für kommerzielle Zwecke</u> verwendet werden.
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]].


Mit der [[Opencaching-API]] ist eine weitere, komfortablere Schnittstelle in Arbeit, die auch das Hochladen von Logs ermöglichen wird.
[[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 liegen 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 kann man dagegen gezielt nur die Basisdaten aller Caches abrufen, und es gibt 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 gibt es keine Beschränkung.


== Weblinks ==
== Weblinks ==
* [http://www.opencaching.de/doc/xml Beschreibung der XML-Schnittstelle]
 
* [https://github.com/OpencachingDeutschland/oc-server3/tree/stable/htdocs/util-local/ocxml11client Client-Referenzimplementierung]
* [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:Opencaching]]
[[Kategorie:Geocaching-Software]]
[[Kategorie:Geocaching-Software]]

Aktuelle Version vom 4. August 2020, 14:44 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 liegen 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 kann man dagegen gezielt nur die Basisdaten aller Caches abrufen, und es gibt 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 gibt 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.