From 4ab365b110f2f1f2b736326b7059244a32115089 Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 11 Feb 2021 14:45:38 +0100 Subject: unslug de: move --- files/de/web/webapi/index.html | 134 ---------- .../webapi/verwenden_von_geolocation/index.html | 291 --------------------- 2 files changed, 425 deletions(-) delete mode 100644 files/de/web/webapi/index.html delete mode 100644 files/de/web/webapi/verwenden_von_geolocation/index.html (limited to 'files/de/web/webapi') diff --git a/files/de/web/webapi/index.html b/files/de/web/webapi/index.html deleted file mode 100644 index 0726dd787a..0000000000 --- a/files/de/web/webapi/index.html +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: WebAPI -slug: Web/WebAPI -tags: - - Apps - - DOM - - Firefox OS - - Mobile -translation_of: Web/API -translation_of_original: WebAPI ---- -

WebAPI ist ein Begriff, der auf eine Palette von Zugangs APIs verweist, die Web-Anwendungen erlaubt auf Geräte-Hardware (wie z. B. den Batteriestatus oder die Vibrations Hardware) zu zugreifen. Der Zugriff auf Daten (z. B. Kalender oder Kontakte), die auf dem Gerät gespeichert wurden ist ebenso möglich. Durch das Hinzufügen dieser APIs, hoffen wir, dass das Web um Funktionen erweitert wird, die proprietär Plattformen schon länger bereitstellen.

- -
-

Hinweis: More of this documentation has been written than it looks like; links are not all added yet. We're actively working on improving this and expect to see things much better over the next couple of weeks. See the WebAPI doc status page, where we're tracking work on WebAPI docs.

-
- -
-

Hinweis: Eine kurze Erläuterung der einzelnen Plaketten finden Sie in der Dokumentation für gepackte Apps.

-
- -
-
-

Kommunikations APIs

- -
-
Netzwerkinformation API
-
Stellt grundlegende Informationen über die aktuelle Netzwerkverbindung so wie Verbindungsgeschwindigkeit zur verfügung.
-
Bluetooth {{NonStandardBadge}}
-
Die WebBluetooth API bietet Low-Level-Zugriff auf die Bluetooth-Hardware des Geräts.
-
Mobile Verbindung API {{NonStandardBadge}}
-
Bietet Informationen über die Mobilfunk-Konnektivität des Gerätes, Signalstärke, Bedieninformationen, usw.
-
Netzwerkstatistik API {{NonStandardBadge}}
-
Zeichnet die Datennutzung auf und stellt diese Daten privilegierten Anwendungen zurverfügung.
-
TCP Socket API {{NonStandardBadge}}
-
Bietet Low-Level-Sockets und SSL-Unterstützung.
-
Telefonie {{NonStandardBadge}}
-
Ermöglicht Apps Anrufe zu tätigen, entgegen zu nehmen und die integrierte Telefonie-Benutzeroberfläche zu nutzen.
-
WebSMS {{NonStandardBadge}}
-
Ermöglicht Apps SMS-Nachrichten zu senden und zu empfangen, sowie den Zugriff und die Verwaltung der auf dem Gerät gespeicherten Nachrichten.
-
WiFi-Informations API {{NonStandardBadge}}
-
Eine privilegierte API, die Informationen über Signalstärke, den Namen des aktuellen Netzwerks und Verfügbare WiFi-Netzwerke bereit stellt.
-
- -

Hardware Zugriff APIs

- -
-
Umgebungslichtsensor API
-
Bietet Zugriff auf den Umgebungslichtsensor der es einer App möglich macht die Umgebungslichtstärke in der Umgebung des Geräts erfassen können.
-
Batteriestatus API
-
Enthält Informationen über den Ladezustand der Batterie und ob das Gerät gerade and den Strom angeschlossen ist.
-
Geolocation API
-
Stellt Informationen zu physischen Standort des Gerätes bereit.
-
Zeiger Sperr API
-
Ermöglicht Apps den Zugriff auf die Maus zu sperren und gewährt den Zugang zu Bewegung Deltas anstatt absoluten Koordinaten; das ist großartig für Spiele.
-
Annäherungs API
-
Mit dieser API können Sie eine Annäherung an das Gerät erfassen, wie durch ein Objekt oder das Gesicht des Benutzers.
-
Geräte Ausrichtungs API
-
Bietet Benachrichtigung, wenn sich die Ausrichtung des Gerätes ändert.
-
Bildschirmausrichtungs API
-
Bietet Benachrichtigung, wenn sich die Ausrichtung des Bildschirms ändert. Diese API ermöglicht ihrer App fest zu legen welche Ausrichtung sie bevorzugt.
-
Vibrations API
-
Ermöglicht Apps die Vibrations Hardware des Geräts zu steuern (für Dinge wie haptisches Feedback in Spielen). Dies ist nicht für Dinge wie Benachrichtigungs Vibrationen bestimmt. Siehe Alarm API.
-
Kamera API {{NonStandardBadge}}
-
Ermöglicht es Apps, Fotos und / oder Videoaufnahmen mit der in das Gerät integrierten Kamera zu machen.
-
Energieverwaltungs API {{NonStandardBadge}}
-
Ermöglicht Apps das Ein-und Ausschalten von Bildschirm, CPU, Netzgerät und so weiter. Auch bietet es Unterstützung für das Lauschen auf und das Untersuchen von Ressourcensperre Events.
-
- -

Alles anzeigen...

-
- -
-

Datenverwaltungs APIs

- -
-
FileHandle API {{NonStandardBadge}}
-
Bietet Unterstützung für schreibbare Dateien mit Sperr Unterstützung.
-
IndexedDB
-
Client-seitige Speicherung von strukturierten Daten mit Unterstützung für High-Performance-Suchanfragen.
-
Einstellungen API {{NonStandardBadge}}
-
Bietet Apps die Möglichkeit, systemweite Konfigurationsoptionen, die dauerhaft auf dem Gerät gespeichert sind, zu prüfen und zu ändern.
-
- -

Weitere APIs

- -
-
Alarm API
-
Ermöglicht es Apps, Benachrichtigungen zeitlich festzulegen. Bietet auch Unterstützung dafür, eine App zu einem bestimmten Zeitpunkt automatisch zu starten.
-
Einfache Push API
-
Lässt die Plattform Benachrichtigungsmeldungen an bestimmte Anwendungen senden.
-
Web Meldungen
-
Ermöglicht Anwendungen das Senden von Meldungen, welche auf Systemebene angezeigt werden.
-
Apps API {{NonStandardBadge}}
-
Die Open WebApps API unterstützt die Installation und Verwaltung von Web-Apps. Darüber hinaus wird Unterstützung für die Ermittlung von Zahlungsinformationen für Apps bereitgestellt.
-
Web Activities {{NonStandardBadge}}
-
Ermöglicht einer App das Delegieren einer Aktivität an eine andere Anwendung; beispielsweise könnte eine App eine andere App bitten, ein Foto auszuwählen (oder zu erstellen) und dieses zurückzuliefern. Normalerweise kann der Anwender konfigurieren, welche Apps für welche Tätigkeiten eingesetzt werden.
-
Web-Bezahlung API {{NonStandardBadge}}
-
Ermöglicht es Web-Inhalten, Zahlungen und Erstattungen für virtuelle Güter zu initiieren.
-
Browser API {{NonStandardBadge}}
-
Bietet Unterstützung für den Aufbau eines Web-Browsers komplett mit Web-Technologien (im Wesentlichen, einen Browser in einem Browser).
-
- -
-
Idle API
-
Ermöglicht Apps Benachrichtigungen zu erhalten, wenn der Benutzer das Gerät nicht aktiv verwendet.
-
Berechtigungen API {{NonStandardBadge}}
-
Verwaltet App-Berechtigungen an einem zentralen Ort. Wird von der Einstellungen-App verwendet.
-
Zeit/Uhr API {{NonStandardBadge}}
-
Bietet Unterstützung für die Einstellung der aktuellen Uhrzeit. Die Zeitzone wird eingestellt mit der Einstellungen API.
-
- -

WebAPI Community

- -

Wenn Sie Hilfe mit diesen APIs benötigen, gibt es mehrere Möglichkeiten, sprechen sie mit Entwicklern.

- -
    -
  • Wenden Sie sich an das WebAPI Forum: {{DiscussionList("dev-webapi", "mozilla.dev.webapi")}}
    • -
  • Besuchen Sie den WebAPI IRC-Kanal: #webapi
    • -
- -

Don't forget about the netiquette...

- - - - -
-
- -

 

diff --git a/files/de/web/webapi/verwenden_von_geolocation/index.html b/files/de/web/webapi/verwenden_von_geolocation/index.html deleted file mode 100644 index 65be452a5a..0000000000 --- a/files/de/web/webapi/verwenden_von_geolocation/index.html +++ /dev/null @@ -1,291 +0,0 @@ ---- -title: Verwenden von geolocation -slug: Web/WebAPI/verwenden_von_geolocation -translation_of: Web/API/Geolocation_API ---- -

Die "geolocation"-API ermöglicht es Nutzern, einer Web-Applikation die eigene Position mitzuteilen. Um die Privatsphäre des Nutzers zu schützen, wird dieser vorher um Erlaubnis gebeten und muss der Übermittlung zustimmen.

- -

Das geolocation-Objekt

- -

Die geolocation-API wird durch das {{domxref("window.navigator.geolocation","navigator.geolocation")}}-Objekt offengelegt.

- -

Wenn das Objekt existiert, sind die geolocation-Services vorhanden und nutzbar. Sie können die Funktionstüchtigkeit daher wie folgt testen:

- -
if ("geolocation" in navigator) {
-  /* geolocation funktioniert */
-} else {
-  /* geolocation funktioniert NICHT */
-}
-
- -
-

Notiz: In Firefox 24 und älteren Versionen hat "geolocation" in navigator immer true zurückgegeben, auch wenn die API ausgeschaltet war. Dies wurde mit Firefox 25 gelöst um mit dem Standard kompatibel zu sein. ({{ bug(884921) }})

-
- -

Die derzeitige Position abfragen

- -

Um die derzeitige Position des Nutzers zu erhalten, können Sie die Methode {{domxref("window.navigator.geolocation.getCurrentPosition()","getCurrentPosition()")}} aufrufen. Dies startet eine asynchrone Anfrage für den Abruf der Position zu initiieren. Wenn die Position erhalten wurde, wird die übergebene Callback-Funktion ausgeführt. Sie können optional auch eine zweite Callback-Funktion übergeben, welche im Falle eines Fehlers ausgeführt wird. Ein dritter, optionaler Parameter ist ein Konfigurationsobjekt, in dem Sie das maximale Alter der zurückgegeben Position, die maximale Wartezeit für die Anfrage und den Wunsch für eine hohe Genauigkeit festlegegen können.

- -
-

Notiz: Standardmäßig versucht {{domxref("window.navigator.geolocation.getCurrentPosition()","getCurrentPosition()")}} so schnell wie möglich mit einer geringen Genauigkeit zu antworten. Es ist nützlich wenn Sie eine schnelle Antwort benötigen, unabhängig von der Genauigkeit. Beispielsweise Geräte mit einem GPS können eine Minute oder länger benötigen um eine neue Position zu erhalten, also kann es möglich sein, dass weniger genaue Daten (Ort der IP oder von WLANs) zurückgegeben werden.

-
- -
navigator.geolocation.getCurrentPosition(function(position) {
-  do_something(position.coords.latitude, position.coords.longitude);
-});
- -

Das obige Beispiel wird die Funktion do_something() ausführen, wenn eine Position erhalten wurde.

- -

Die derzeitige Position überwachen

- -

Wenn sich die Positionsdaten ändern (entweder über die Bewegung des Gerätes oder den Erhalt genauere Geolokationsdaten), können Sie eine Callback-Funktion erstellen, die mit der erneuerten Positionsinformation arbeitet. Dies ist über die Funktion {{domxref("window.navigator.geolocation.watchPosition()","watchPosition()")}} möglich, welche die gleichen Eingabeparameter wie {{domxref("window.navigator.geolocation.getCurrentPosition()","getCurrentPosition()")}}. besitzt. Die Callback-Funktion wird mehrere Male ausgeführt, dies erlaubt dem Browser die Position aufgrund von Bewegungen oder genaueren Positionsdaten, durch das Verwenden von anderen (langsameren) Methoden, zu erneuern. Die Fehler-Callback-Funktion, welche wie auch in {{domxref("window.navigator.geolocation.getCurrentPosition()","getCurrentPosition()")}},  hier optional ist, kann auch mehrfach aufgerufen werden.

- -
-

Notiz: Sie können  {{domxref("window.navigator.geolocation.watchPosition()","watchPosition()")}} auch ohne ein vorangestellten Aufruf von {{domxref("window.navigator.geolocation.getCurrentPosition()","getCurrentPosition()")}} nutzen.

-
- -
var watchID = navigator.geolocation.watchPosition(function(position) {
-  do_something(position.coords.latitude, position.coords.longitude);
-});
- -

Die Methode {{domxref("window.navigator.geolocation.watchPosition()","watchPosition()")}} gibt eine numerische ID zurück, die für die eindeutige Identifikation des Positionsüberwachers verwendet werden kann; diese können Sie in der Methode {{domxref("window.navigator.geolocation.clearWatch()","clearWatch()")}} nutzen, um die Positionsüberwachung zu beenden.

- -
navigator.geolocation.clearWatch(watchID);
-
- -

Anpassen der Antwort

- -

Sowohl {{domxref("window.navigator.geolocation.getCurrentPosition()","getCurrentPosition()")}} als auch {{domxref("window.navigator.geolocation.watchPosition()","watchPosition()")}} nehmen einen Erfolgs-Callback an, einen optionalen Fehler-Callback und ein optionales PositionOptions-Objekt.

- -

{{page("/en-US/docs/DOM/window.navigator.geolocation.getCurrentPosition","PositionOptions")}}

- -

Ein Aufruf von {{domxref("window.navigator.geolocation.watchPosition()","watchPosition")}} könnte wie folgt aussehen:

- -
function geo_success(position) {
-  do_something(position.coords.latitude, position.coords.longitude);
-}
-
-function geo_error() {
-  alert("Entschuldigung, keine Positionsinformationen sind verfügbar.");
-}
-
-var geo_options = {
-  enableHighAccuracy: true,
-  maximumAge        : 30000,
-  timeout           : 27000
-};
-
-var wpid = navigator.geolocation.watchPosition(geo_success, geo_error, geo_options);
- -

Ein (englisches) Beispiel von watchPosition in Aktion: http://www.thedotproduct.org/experiments/geo/
- 

- -

Darstellung einer Position

- -

Die Position des Nutzers wird durch ein Position-Objekt dargestellt, welches ein Coordinates-Objekt referenziert.

- -

{{page("/en-US/docs/DOM/window.navigator.geolocation.getCurrentPosition","Position")}}

- -

{{page("/en-US/docs/DOM/window.navigator.geolocation.getCurrentPosition","Coordinates")}}

- -

Fehlerbehandlung

- -

Die Fehler-Callback-Funktion, wenn im Aufruf von getCurrentPosition() oder watchPosition() vorhanden, nimmt ein PositionError-Objekt als ersten Parameter an.

- -
function errorCallback(error) {
-  alert('ERROR(' + error.code + '): ' + error.message);
-};
-
- -

{{page("/en-US/docs/DOM/window.navigator.geolocation.getCurrentPosition","PositionError")}}

- -

Geolokations-Live-Beispiel

- - - -

HTML Content

- -
<p><button onclick="geoFindMe()">Zeige meine Position an</button></p>
-<div id="out"></div>
-
- -

JavaScript Content

- -
function geoFindMe() {
-  var output = document.getElementById("out");
-
-  if (!navigator.geolocation){
-    output.innerHTML = "<p>Geolokation wird von ihrem Browser nicht unterstützt</p>";
-    return;
-  }
-
-  function success(position) {
-    var latitude  = position.coords.latitude;
-    var longitude = position.coords.longitude;
-
-    output.innerHTML = '<p>Die Latitude ist ' + latitude + '° <br>Die Longitude ist ' + longitude + '°</p>';
-
-    var img = new Image();
-    img.src = "http://maps.googleapis.com/maps/api/staticmap?center=" + latitude + "," + longitude + "&zoom=13&size=300x300&sensor=false";
-
-    output.appendChild(img);
-  };
-
-  function error() {
-    output.innerHTML = "Es war nicht möglich Sie zu lokalisieren";
-  };
-
-  output.innerHTML = "<p>Lokalisieren…</p>";
-
-  navigator.geolocation.getCurrentPosition(success, error);
-}
-
- -

Demo:

- -

{{ EmbedLiveSample('Geolokations-Live-Beispiel',350,410) }}

- -

Für die Erlaubnis fragen

- -

Jedes Add-On von addons.mozilla.org, welches dieses Feature nutzt, muss explizit, ähnlich der automatischen Frage von Websites, nach Erlaubnis fragen. Die Antwort des Nutzers wird in einer Konfiguration gespeichert, welche von pref-Parameter bestimmt wird, wenn möglich. Die Funktion, die als callback-Parameter verwendet wird mit einem boolischen Wert aufgerufen, welcher die Antwort des Nutzers anzeigt. Wenn dieser true ist, kann das Add-On Geolokationsdaten nutzen.

- -
function prompt(window, pref, message, callback) {
-    let branch = Components.classes["@mozilla.org/preferences-service;1"]
-                           .getService(Components.interfaces.nsIPrefBranch);
-
-    if (branch.getPrefType(pref) === branch.PREF_STRING) {
-        switch (branch.getCharPref(pref)) {
-        case "always":
-            return callback(true);
-        case "never":
-            return callback(false);
-        }
-    }
-
-    let done = false;
-
-    function remember(value, result) {
-        return function() {
-            done = true;
-            branch.setCharPref(pref, value);
-            callback(result);
-        }
-    }
-
-    let self = window.PopupNotifications.show(
-        window.gBrowser.selectedBrowser,
-        "geolocation",
-        message,
-        "geo-notification-icon",
-        {
-            label: "Ort teilen",
-            accessKey: "S",
-            callback: function(notification) {
-                done = true;
-                callback(true);
-            }
-        }, [
-            {
-                label: "Immer teilen",
-                accessKey: "A",
-                callback: remember("always", true)
-            },
-            {
-                label: "Niemals teilen",
-                accessKey: "N",
-                callback: remember("never", false)
-            }
-        ], {
-            eventCallback: function(event) {
-                if (event === "dismissed") {
-                    if (!done) callback(false);
-                    done = true;
-                    window.PopupNotifications.remove(self);
-                }
-            },
-            persistWhileVisible: true
-        });
-}
-
-prompt(window,
-       "extensions.foo-addon.allowGeolocation",
-       "Foo Add-on möchte deinen Ort abrufen.",
-       function callback(allowed) { alert(allowed); });
-
- -

Browser compatibility

- -
{{ CompatibilityTable() }}
- -
 
- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Grundsätzlicher Support5{{CompatGeckoDesktop("1.9.1")}}910.60
- Removed in 15.0
- Reintroduced in 16.0		5
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Grundsätzlicher Support2.111{{CompatGeckoMobile("4")}}1010.603.2
-
- -

Gecko-Notizen

- -

Firefox besitzt Support für das Lokalisieren über WLAN-Informationen durch die "Google Location"-Services. In einer Transaktion zwischen Firefox und Google werden die Daten übetragen, inklusive Daten des WLAN-Zugriffspunktes, einem Zugriffstoken (ähnlich wie ein zweiwöchiger Cookie), und der IP-Adresse des Nutzers. Für mehr Informationen sollten Sie Mozillas und Googles Datenschutzbestimmungen lesen, welche den Rahmen der Datennutzung angeben.

- -

Siehe auch

- - -- cgit v1.2.3-54-g00ecf