diff options
Diffstat (limited to 'files/de/web/webapi')
| -rw-r--r-- | files/de/web/webapi/index.html | 133 | ||||
| -rw-r--r-- | files/de/web/webapi/verwenden_von_geolocation/index.html | 291 |
2 files changed, 424 insertions, 0 deletions
diff --git a/files/de/web/webapi/index.html b/files/de/web/webapi/index.html new file mode 100644 index 0000000000..6dd336c62e --- /dev/null +++ b/files/de/web/webapi/index.html @@ -0,0 +1,133 @@ +--- +title: WebAPI +slug: Web/WebAPI +tags: + - Apps + - DOM + - Firefox OS + - Mobile +translation_of: Web/API +--- +<p><strong>WebAPI</strong> 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.</p> + +<div class="note"> +<p><span id="result_box" lang="de"><strong><span class="hps">Hinweis:</span></strong> 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 <a href="https://developer.mozilla.org/en-US/docs/WebAPI/Doc_status" title="WebAPI/Doc_status">WebAPI doc status page</a>, where we're tracking work on WebAPI docs.</span></p> +</div> + +<div class="note"> +<p><span id="result_box" lang="de"><span class="hps"><strong>Hinweis</strong>:</span> E<span class="hps">ine</span> <span class="hps">kurze Erläuterung der einzelnen</span> <span class="short_text" id="result_box" lang="de"><span class="alt-edited hps">Plaketten </span></span><span class="hps">finden Sie in der</span></span> Dokumentation für <a href="/en-US/docs/Web/Apps/Packaged_apps#Types_of_packaged_apps" title="Web/Apps/Packaged_apps#Types_of_packaged_apps">gepackte Apps</a>.</p> +</div> + +<div class="row topicpage-table"> +<div class="section"> +<h2 class="Documentation" id="Communication_APIs" name="Communication_APIs"><span class="short_text" id="result_box" lang="de"><span class="hps">Kommunikations </span></span>APIs</h2> + +<dl> + <dt><a href="/en-US/docs/WebAPI/Network_Information" title="WebAPI/Network_Information"><span class="short_text" id="result_box" lang="de"><span class="alt-edited hps">Netzwerkinformation</span> <span class="hps">API</span></span></a></dt> + <dd><span id="result_box" lang="de"><span class="hps">Stellt grundlegende</span> <span class="hps">Informationen über die aktuelle </span><span class="hps">Netzwerkverbindung</span> so <span class="hps">wie</span> <span class="hps">Verbindungsgeschwindigkeit zur verfügung.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/WebBluetooth" title="WebAPI/WebBluetooth">Bluetooth</a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Die</span> <span class="hps">WebBluetooth</span> <span class="hps">API bietet</span> <span class="atn hps">Low-Level-</span><span>Zugriff auf</span> die <span class="hps">Bluetooth-Hardware</span> <span class="hps">des Geräts.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Mobile_Connection" title="WebAPI/Mobile_Connection">M<span class="short_text" id="result_box" lang="de"><span class="alt-edited hps">obile Verbindung</span></span> API</a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Bietet</span> <span class="hps">Informationen über</span> die <span class="hps">Mobilfunk-Konnektivität</span> <span class="hps">des Gerätes</span><span>,</span> <span class="hps">Signalstärke</span><span>, Bedieninformationen</span>, <span class="hps">usw</span><span class="hps">.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Network_Stats" title="WebAPI/Network_Stats"><span class="short_text" id="result_box" lang="de"><span class="hps">Netzwerkstatistik </span></span>API</a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Zeichnet </span><span class="hps">die Datennutzung</span> auf <span class="hps">und stellt</span> <span class="hps">diese Daten</span> <span class="hps">privilegierten</span> <span class="hps">Anwendungen zurverfügung.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/TCP_Socket" title="WebAPI/TCP_Socket">TCP Socket API</a> {{NonStandardBadge}}</dt> + <dd><span class="short_text" id="result_box" lang="de"><span class="hps">Bietet</span> <span class="atn hps">Low-Level-</span><span>Sockets und</span> <span class="hps">SSL-Unterstützung.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/WebTelephony" title="WebAPI/WebTelephony"><span class="short_text" id="result_box" lang="de"><span class="hps">Telefonie</span></span></a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Ermöglicht</span> <span class="hps">Apps</span> <span>Anrufe zu tätigen, entgegen zu nehmen und</span> <span class="hps">die integrierte</span> <span class="atn hps">Telefonie-</span><span>Benutzeroberfläche zu nutzen.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/WebSMS" title="WebAPI/WebSMS">WebSMS </a>{{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Ermöglicht</span> <span class="hps">Apps</span> <span class="hps"><span id="result_box" lang="de"><span class="hps">SMS-Nachrichten</span></span> zu senden und zu empfangen</span><span class="hps">,</span> sowie<span class="hps"> </span><span class="hps">den Zugriff und die Verwaltung der</span> <span class="hps">auf dem Gerät gespeicherten</span> <span class="hps">Nachrichten.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/WiFi_Information" title="WebAPI/WiFi_Information"><span class="short_text" id="result_box" lang="de"><span class="atn hps">WiFi-</span><span>Informations </span></span>API</a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Eine privilegierte</span> <span class="hps">API</span><span>, die Informationen über</span> <span class="hps">Signalstärke</span><span>,</span> <span class="hps">den Namen</span> <span class="hps">des aktuellen Netzwerks</span><span> und Verfügbare </span><span class="hps">WiFi-Netzwerke</span><span class="hps"> bereit stellt.</span></span></dd> +</dl> + +<h2 class="Documentation" id="Hardware_access_APIs" name="Hardware_access_APIs"><span class="short_text" id="result_box" lang="de"><span class="hps">Hardware</span> <span class="hps">Zugriff APIs</span></span></h2> + +<dl> + <dt><a href="/en-US/docs/WebAPI/Using_Light_Events"><span class="short_text" id="result_box" lang="de"><span class="alt-edited hps">Umgebungslichtsensor</span> <span class="hps">API</span></span></a></dt> + <dd><span id="result_box" lang="de"><span class="alt-edited hps">Bietet Zugriff auf den</span> <span class="hps">Umgebungslichtsensor</span><span class="hps"> der</span> es einer<span class="hps"> App möglich macht</span><span class="hps"> die</span> <span class="hps">Umgebungslichtstärke</span> <span class="hps">in</span> <span class="hps">der Umgebung des</span> <span class="hps">Geräts erfassen können</span><span>.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Battery_Status" title="WebAPI/Battery_Status"><span class="short_text" id="result_box" lang="de"><span class="alt-edited hps">Batteriestatus</span> <span class="hps">API</span></span></a></dt> + <dd><span id="result_box" lang="de"><span class="hps">Enthält Informationen über</span> <span class="hps">den Ladezustand der</span> <span class="hps">Batterie</span> <span class="hps">und ob</span> <span class="hps">das Gerät gerade</span> <span class="hps">and den Strom angeschlossen ist</span><span class="hps">.</span></span></dd> + <dt><a href="/en-US/docs/Using_geolocation" title="Using_geolocation">Geolocation API</a></dt> + <dd><span id="result_box" lang="de"><span class="hps">Stellt Informationen zu</span> <span class="hps">physischen Standort</span> <span class="hps">des Gerätes bereit.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Pointer_Lock" title="API/Pointer_Lock_API"><span class="short_text" id="result_box" lang="de"><span class="alt-edited hps">Zeiger</span> Sperr<span class="hps"> API</span></span></a></dt> + <dd><span id="result_box" lang="de"><span class="hps">Ermöglicht</span> <span class="hps">Apps</span> den <span class="hps">Zugriff auf die Maus</span> zu <span id="result_box" lang="de"><span class="hps">sperren</span> </span><span class="hps">und gewährt den Zugang zu</span> <span class="hps">Bewegung</span> <span class="hps">Deltas</span> <span class="hps">anstatt</span> <span class="hps">absoluten Koordinaten</span><span>; das ist</span> <span class="hps">großartig</span> <span class="hps">für Spiele.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Proximity" title="WebAPI/Proximity"><span class="short_text" id="result_box" lang="de"><span class="alt-edited hps">Annäherungs</span> </span>API</a></dt> + <dd><span id="result_box" lang="de"><span class="hps">Mit dieser API können Sie</span> eine <span class="hps">Annäherung an</span> <span class="hps">das Gerät</span><span class="hps"> erfassen, wie durch </span><span class="hps">ein</span> <span class="hps">Objekt</span> <span class="hps">oder </span><span class="hps">das Gesicht des Benutzers</span><span>.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Detecting_device_orientation" title="WebAPI/Detecting_device_orientation"><span class="short_text" id="result_box" lang="de"><span class="hps">Geräte</span> <span class="hps">Ausrichtung</span>s </span>API</a></dt> + <dd><span id="result_box" lang="de"><span class="hps">Bietet</span> <span class="hps">Benachrichtigung, wenn</span> sich <span class="hps">die Ausrichtung des</span> <span class="hps">Gerätes</span> <span class="hps">ändert</span><span>.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Managing_screen_orientation" title="WebAPI/Detecting_device_orientation"><span class="short_text" id="result_box" lang="de"><span class="hps">Bildschirmausrichtung</span>s <span class="hps">API</span></span></a></dt> + <dd><span id="result_box" lang="de"><span class="hps">Bietet</span> <span class="hps">Benachrichtigung, wenn</span> sich <span class="hps">die Ausrichtung des</span> <span class="hps">Bildschirms</span> <span class="hps">ändert</span><span>.</span> <span class="hps">Diese</span> <span class="hps">API ermöglicht ihrer App fest zu legen</span><span class="hps"> welche</span> <span class="hps">Ausrichtung</span> sie <span class="hps">bevorzugt.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Vibration" title="WebAPI/Vibration"><span class="short_text" id="result_box" lang="de"><span class="hps">Vibration</span>s <span class="hps">API</span></span></a></dt> + <dd><span id="result_box" lang="de"><span class="hps">Ermöglicht</span> <span class="hps">Apps</span> die <span class="hps">Vibrations</span> <span class="hps">Hardware</span> <span class="hps">des Geräts</span> zu steuern (<span class="hps">für Dinge wie</span> <span class="hps">haptisches Feedback</span> <span class="hps">in Spielen).</span> <span class="hps">Dies ist <strong>nicht</strong></span><strong> </strong><span class="hps">für Dinge wie</span> <span class="hps">Benachrichtigungs</span> <span class="hps">Vibrationen</span> <span class="hps">bestimmt</span><span>.</span> <span class="hps">Siehe</span> <a href="https://developer.mozilla.org/en-US/docs/WebAPI/Alarm"><span class="hps">Alarm</span> <span class="hps">API</span></a><span class="hps">.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Camera" title="WebAPI/Camera">Kamera API</a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Ermöglicht es Apps,</span> <span class="hps">Fotos und / oder</span> <span class="hps">Videoaufnahmen</span> <span class="hps">mit</span> <span class="hps">der in das Gerät</span> <span class="hps">integrierten Kamera</span><span> zu machen.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Power_Management" title="WebAPI/Power_Management"><span class="short_text" id="result_box" lang="de"><span class="alt-edited hps">Energieverwaltungs </span></span>API</a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Ermöglicht</span><span class="hps"> Apps <span id="result_box" lang="de"><span class="hps">das <span id="result_box" lang="de"><span class="hps"><span id="result_box" lang="de"><span class="hps">Ein-und</span> <span class="hps">Aus</span><span>schalten</span></span></span></span> von Bildschirm</span></span></span><span>, CPU,</span> <span class="hps">Netzgerät</span><span> </span><span class="hps">und so weiter.</span> <span class="hps">Auch</span> <span class="hps">bietet es Unterstützung</span> <span class="hps">für das Lauschen</span> auf <span class="hps">und das Untersuchen</span> von <span class="hps">Ressourcensperre</span> <span class="hps">Events.</span></span></dd> +</dl> + +<p><span class="alllinks"><a href="/en-US/docs/tag/WebAPI" title="tag/CSS">Alles anzeigen...</a></span></p> +</div> + +<div class="section"> +<h2 class="Documentation" id="Data_management_APIs" name="Data_management_APIs"><span class="short_text" id="result_box" lang="de"><span class="alt-edited hps">Datenverwaltungs </span><span>APIs</span></span></h2> + +<dl> + <dt><a href="/en-US/docs/WebAPI/FileHandle_API" title="WebAPI/FileHandle_API">FileHandle API</a> {{NonStandardBadge}}</dt> + <dd>Bietet Unterstützung für schreibbare Dateien mit Sperr Unterstützung.</dd> + <dt><a href="/en-US/docs/IndexedDB" title="IndexedDB">IndexedDB</a></dt> + <dd>Client-seitige Speicherung von strukturierten Daten mit Unterstützung für High-Performance-Suchanfragen.</dd> + <dt><a href="/en-US/docs/WebAPI/Settings" title="WebAPI/Settings">Einstellungen API</a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Bietet </span><span class="hps">Apps</span> die Möglichkeit, <span class="hps">systemweite</span> <span class="hps">Konfigurationsoptionen, die</span> <span class="hps">dauerhaft auf dem</span> <span class="hps">Gerät gespeichert sind, zu <span id="result_box" lang="de"><span class="hps">prüfen und zu ändern</span></span>.</span></span></dd> +</dl> + +<h2 class="Documentation" id="Other_APIs" name="Other_APIs"><span class="short_text" id="result_box" lang="de"><span class="hps">Weitere</span> <span class="hps">APIs</span></span></h2> + +<dl> + <dt><a href="/en-US/docs/WebAPI/Alarm" title="WebAPI/Alarm">Alarm API</a></dt> + <dd>Ermöglicht es Apps, Benachrichtigungen zeitlich festzulegen. Bietet auch Unterstützung dafür, eine App zu einem bestimmten Zeitpunkt automatisch zu starten.</dd> + <dt><a href="/en-US/docs/WebAPI/Simple_Push" title="WebAPI/Push_Notifications">Einfache Push API</a></dt> + <dd><span id="result_box" lang="de"><span class="hps">Lässt</span> <span class="hps">die Plattform</span> <span class="hps">Benachrichtigungsmeldungen</span> <span class="hps">an bestimmte Anwendungen</span> <span class="hps">senden.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Using_Web_Notifications" title="/en-US/docs/WebAPI/Using_Web_Notifications">Web Meldungen</a></dt> + <dd><span id="result_box" lang="de"><span class="hps">Ermöglicht</span> <span class="hps">Anwendungen das Senden</span> von <span class="hps">Meldungen</span>, welche <span class="hps">auf Systemebene</span> <span class="hps">angezeigt werden.</span></span></dd> + <dt><a href="/en-US/docs/Apps" title="Apps">Apps API</a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Die Open</span> <span class="hps">WebApps</span> <span class="hps">API</span> <span class="hps">unterstützt </span><span class="hps">die Installation und</span> <span class="hps">Verwaltung von Web</span><span>-Apps.</span> <span class="hps">Darüber hinaus wird</span> <span class="hps">Unterstützung</span> für die Ermittlung von <span class="hps">Zahlungsinformationen</span> für<span id="result_box" lang="de"><span class="hps"> Apps </span></span><span id="result_box" lang="de"><span class="hps">bereitgestellt</span></span><span>.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Web_Activities" title="WebAPI/Web_Activities">Web Activities</a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Ermöglicht</span> <span class="hps">einer App</span> <span class="hps">das Delegieren</span> <span class="hps">einer Aktivität</span> <span class="hps">an eine andere Anwendung</span><span>;</span> <span class="hps">beispielsweise könnte </span><span class="hps">eine App</span> <span class="hps">eine andere App</span> <span class="hps">bitten, ein Foto</span> <span class="atn hps">auszuwählen (</span><span>oder zu erstellen)</span> <span class="hps">und dieses zurückzuliefern</span><span>.</span> <span class="hps">Normalerweise</span> <span class="hps">kann der Anwender</span> <span class="hps">konfigurieren</span><span>, welche</span> <span class="hps">Apps</span> <span class="hps">für welche Tätigkeiten</span> <span class="hps">eingesetzt werden.</span></span></dd> + <dt><a href="/en-US/docs/Apps/Publishing/In-app_payments" title="Apps/Publishing/In-app_payments">Web-Bezahlung API</a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Ermöglicht es </span><span class="hps">Web-Inhalten,</span> <span class="hps">Zahlungen</span> <span class="hps">und Erstattungen</span> <span class="hps">für virtuelle Güter zu initiieren</span><span>.</span></span></dd> + <dt><a href="/en-US/docs/DOM/Using_the_Browser_API" title="DOM/Using_the_Browser_API"><strong>Browser API</strong></a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Bietet Unterstützung</span> <span class="hps">für den Aufbau eines</span> <span class="hps">Web-Browsers</span> <span class="hps">komplett</span> <span class="hps">mit Web</span><span>-Technologien</span> <span class="atn hps">(</span><span>im Wesentlichen,</span> <span class="hps">einen Browser</span> <span class="hps">in einem Browser</span><span>)</span><span>.</span></span></dd> +</dl> + +<dl> + <dt><a href="/en-US/docs/WebAPI/Idle" title="WebAPI/Device_Storage_API">Idle API</a></dt> + <dd><span id="result_box" lang="de"><span class="hps">Ermöglicht</span> <span class="hps">Apps</span> <span class="hps">Benachrichtigungen zu erhalten</span><span>, wenn der Benutzer</span> <span id="result_box" lang="de"><span class="hps">das Gerät </span></span><span class="hps">nicht aktiv</span> <span class="hps">verwendet.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Permissions" title="WebAPI/Permissions">Berechtigungen API</a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Verwaltet</span> <span class="hps">App</span><span>-Berechtigungen an</span> <span class="hps">einem zentralen Ort</span><span>.</span> <span class="hps">Wird von der</span> <span>Einstellungen-<span id="result_box" lang="de"><span class="hps">App verwendet</span></span></span><span>.</span></span></dd> + <dt><a href="/en-US/docs/WebAPI/Time_and_Clock" title="WebAPI/Time_and_Clock">Zeit/Uhr API</a> {{NonStandardBadge}}</dt> + <dd><span id="result_box" lang="de"><span class="hps">Bietet Unterstützung</span> <span class="hps">für die Einstellung der</span> <span class="hps">aktuellen Uhrzeit.</span> <span class="hps">Die Zeitzone wird</span> <span class="hps">eingestellt</span> <span class="hps">mit</span> <span class="hps">der</span></span> <a href="/en-US/docs/WebAPI/Settings" title="WebAPI/Settings">Einstellungen API</a>.</dd> +</dl> + +<h2 class="Community" id="Community" name="Community"><span class="short_text" id="result_box" lang="de"><span class="hps">WebAPI</span> <span class="hps">Community</span></span></h2> + +<p><span id="result_box" lang="de"><span class="hps">Wenn Sie Hilfe</span> <span class="hps">mit diesen</span> <span class="hps">APIs</span> <span class="hps">benötigen, gibt es</span> <span class="hps">mehrere Möglichkeiten,</span> </span><span id="result_box" lang="de"><span class="hps">sprechen sie mit </span></span><span id="result_box" lang="de"><span class="hps">Entwicklern</span><span class="hps">.</span></span></p> + +<ul> + <li><span class="short_text" id="result_box" lang="de"><span class="hps">Wenden Sie sich</span> <span class="hps">an das WebAPI</span> <span class="hps">Forum: </span></span>{{DiscussionList("dev-webapi", "mozilla.dev.webapi")}}</li> + <li><span class="short_text" id="result_box" lang="de"><span class="hps">Besuchen Sie den </span><span class="hps">WebAPI</span> <span class="hps">IRC-Kanal</span></span>: <a href="irc://irc.mozilla.org/webapi" title="irc://irc.mozilla.org/webapi">#webapi</a></li> +</ul> + +<p><span class="alllinks"><a href="http://www.catb.org/~esr/faqs/smart-questions.html" title="http://www.catb.org/~esr/faqs/smart-questions.html">Don't forget about the <em>netiquette</em>...</a></span></p> + +<h2 class="Related_Topics" id="Related_Topics" name="Related_Topics"><span class="short_text" id="result_box" lang="de"><span class="hps">Verwandte Themen</span></span></h2> + +<ul> + <li>Das <a href="/en-US/docs/DOM" title="Document Object Model (DOM)">Document Object Model (DOM)</a><span id="result_box" lang="de"> <span class="hps">ist die</span></span><span id="result_box" lang="de"><span class="hps"> Baum</span></span><span id="result_box" lang="de"><span class="hps"> Darstellung</span> <span class="hps">eines HTML-Dokuments</span><span>.</span></span></li> + <li><a href="/en-US/docs/JavaScript" title="JavaScript">JavaScript</a> - <span class="short_text" id="result_box" lang="de"><span class="hps">Skriptsprache</span> <span class="hps">für das Web.</span></span></li> + <li><a href="/en-US/docs/WebAPI/Doc_status" title="WebAPI/Doc_status">Doc status</a>: <span id="result_box" lang="de"><span>Eine Liste von</span> <span class="hps">WebAPI</span> <span class="hps">Themen</span> <span class="hps">und deren Dokumentation</span> <span class="hps">Status.</span></span></li> +</ul> +</div> +</div> + +<p> </p> diff --git a/files/de/web/webapi/verwenden_von_geolocation/index.html b/files/de/web/webapi/verwenden_von_geolocation/index.html new file mode 100644 index 0000000000..65be452a5a --- /dev/null +++ b/files/de/web/webapi/verwenden_von_geolocation/index.html @@ -0,0 +1,291 @@ +--- +title: Verwenden von geolocation +slug: Web/WebAPI/verwenden_von_geolocation +translation_of: Web/API/Geolocation_API +--- +<p>Die <strong>"geolocation"-API</strong> 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.</p> + +<h2 id="Das_geolocation-Objekt">Das geolocation-Objekt</h2> + +<p>Die geolocation-API wird durch das {{domxref("window.navigator.geolocation","navigator.geolocation")}}-Objekt offengelegt.</p> + +<p>Wenn das Objekt existiert, sind die geolocation-Services vorhanden und nutzbar. Sie können die Funktionstüchtigkeit daher wie folgt testen:</p> + +<pre class="brush: js">if ("geolocation" in navigator) { + /* geolocation funktioniert */ +} else { + /* geolocation funktioniert NICHT */ +} +</pre> + +<div class="note"> +<p><strong>Notiz:</strong> In Firefox 24 und älteren Versionen hat <code>"geolocation" in navigator</code> immer true zurückgegeben, auch wenn die API ausgeschaltet war. Dies wurde mit <a href="/en-US/docs/Mozilla/Firefox/Releases/25/Site_Compatibility">Firefox 25</a> gelöst um mit dem Standard kompatibel zu sein. ({{ bug(884921) }})</p> +</div> + +<h3 id="Die_derzeitige_Position_abfragen">Die derzeitige Position abfragen</h3> + +<p>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.</p> + +<div class="note"> +<p><strong>Notiz:</strong> 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.</p> +</div> + +<pre class="brush: js">navigator.geolocation.getCurrentPosition(function(position) { + do_something(position.coords.latitude, position.coords.longitude); +});</pre> + +<p>Das obige Beispiel wird die Funktion <code>do_something()</code> ausführen, wenn eine Position erhalten wurde.</p> + +<h3 id="Die_derzeitige_Position_überwachen">Die derzeitige Position überwachen</h3> + +<p>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.</p> + +<div class="note"> +<p><strong>Notiz:</strong> Sie können {{domxref("window.navigator.geolocation.watchPosition()","watchPosition()")}} auch ohne ein vorangestellten Aufruf von {{domxref("window.navigator.geolocation.getCurrentPosition()","getCurrentPosition()")}} nutzen.</p> +</div> + +<pre class="brush: js">var watchID = navigator.geolocation.watchPosition(function(position) { + do_something(position.coords.latitude, position.coords.longitude); +});</pre> + +<p>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.</p> + +<pre class="brush: js">navigator.geolocation.clearWatch(watchID); +</pre> + +<h3 id="Anpassen_der_Antwort">Anpassen der Antwort</h3> + +<p>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 <code>PositionOptions</code>-Objekt.</p> + +<p>{{page("/en-US/docs/DOM/window.navigator.geolocation.getCurrentPosition","PositionOptions")}}</p> + +<p>Ein Aufruf von {{domxref("window.navigator.geolocation.watchPosition()","watchPosition")}} könnte wie folgt aussehen:</p> + +<pre class="brush: js">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);</pre> + +<p><a id="fck_paste_padding">Ein (englisches) Beispiel von watchPosition in Aktion: </a><a class="external" href="http://www.thedotproduct.org/experiments/geo/">http://www.thedotproduct.org/experiments/geo/</a><br> + <a id="fck_paste_padding"></a></p> + +<h2 id="Darstellung_einer_Position">Darstellung einer Position</h2> + +<p>Die Position des Nutzers wird durch ein <code>Position</code>-Objekt dargestellt, welches ein <code>Coordinates</code>-Objekt referenziert.</p> + +<p>{{page("/en-US/docs/DOM/window.navigator.geolocation.getCurrentPosition","Position")}}</p> + +<p>{{page("/en-US/docs/DOM/window.navigator.geolocation.getCurrentPosition","Coordinates")}}</p> + +<h2 id="Fehlerbehandlung">Fehlerbehandlung</h2> + +<p>Die Fehler-Callback-Funktion, wenn im Aufruf von <code>getCurrentPosition()</code> oder <code>watchPosition()</code> vorhanden, nimmt ein PositionError-Objekt als ersten Parameter an.</p> + +<pre class="brush: js">function errorCallback(error) { + alert('ERROR(' + error.code + '): ' + error.message); +}; +</pre> + +<p>{{page("/en-US/docs/DOM/window.navigator.geolocation.getCurrentPosition","PositionError")}}</p> + +<h2 id="Geolokations-Live-Beispiel">Geolokations-Live-Beispiel</h2> + +<div class="hidden"> +<pre class="brush: css">body { + padding: 20px; + background-color:#ffffc9 +} + +p { margin : 0; } +</pre> +</div> + +<h3 id="HTML_Content">HTML Content</h3> + +<pre class="brush: html;"><p><button onclick="geoFindMe()">Zeige meine Position an</button></p> +<div id="out"></div> +</pre> + +<h3 id="JavaScript_Content">JavaScript Content</h3> + +<pre class="brush: js;">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); +} +</pre> + +<h3 id="Demo">Demo:</h3> + +<p>{{ EmbedLiveSample('Geolokations-Live-Beispiel',350,410) }}</p> + +<h2 id="Für_die_Erlaubnis_fragen">Für die Erlaubnis fragen</h2> + +<p>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 <code>pref</code>-Parameter bestimmt wird, wenn möglich. Die Funktion, die als <code>callback</code>-Parameter verwendet wird mit einem boolischen Wert aufgerufen, welcher die Antwort des Nutzers anzeigt. Wenn dieser <code>true</code> ist, kann das Add-On Geolokationsdaten nutzen.</p> + +<pre class="brush: js">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); }); +</pre> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + +<div>{{ CompatibilityTable() }}</div> + +<div> </div> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Grundsätzlicher Support</td> + <td>5</td> + <td>{{CompatGeckoDesktop("1.9.1")}}</td> + <td>9</td> + <td>10.60<br> + Removed in 15.0<br> + Reintroduced in 16.0</td> + <td>5</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android</th> + <th>Chrome for Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Grundsätzlicher Support</td> + <td>2.1</td> + <td>11</td> + <td>{{CompatGeckoMobile("4")}}</td> + <td>10</td> + <td>10.60</td> + <td>3.2</td> + </tr> + </tbody> +</table> +</div> + +<h3 id="Gecko-Notizen">Gecko-Notizen</h3> + +<p>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 <a href="http://www.mozilla.com/de/privacy/">Mozillas</a> und <a href="www.google.com/privacy/lsf.html">Googles</a> Datenschutzbestimmungen lesen, welche den Rahmen der Datennutzung angeben.</p> + +<h2 id="Siehe_auch">Siehe auch</h2> + +<ul> + <li>{{domxref("window.navigator.geolocation","navigator.geolocation")}}</li> + <li><a href="http://www.w3.org/TR/geolocation-API/" rel="external" title="http://www.w3.org/TR/geolocation-API/">Geolocation API auf w3.org</a></li> + <li><a href="/en-US/demos/tag/tech:geolocation" title="en-US/demos/tag/tech:geolocation/">Demos für die Geolokations-API</a></li> + <li><a href="https://hacks.mozilla.org/2013/10/who-moved-my-geolocation/">Who moved my geolocation?</a> (Hacks blog)</li> +</ul> |