|
4 | 4 | <meta charset="utf-8"> |
5 | 5 | <meta name="color-scheme" content="light dark"> |
6 | 6 | <title> |
7 | | - Geolocation API |
| 7 | + Geolocation |
8 | 8 | </title> |
9 | 9 | <script src="https://www.w3.org/Tools/respec/respec-w3c" async class= |
10 | 10 | "remove"></script> |
|
39 | 39 | previousPublishDate: "2022-02-17", |
40 | 40 | crEnd: "2022-03-18", |
41 | 41 | previousMaturity: "CR", |
42 | | - github: "w3c/geolocation-api", |
| 42 | + github: "w3c/geolocation", |
43 | 43 | caniuse: "geolocation", |
44 | | - testSuiteURI: "https://wpt.live/geolocation-API/", |
45 | | - implementationReportURI: "https://w3c.github.io/geolocation-api/reports/PR_imp_report.html", |
| 44 | + testSuiteURI: "https://wpt.live/geolocation/", |
| 45 | + implementationReportURI: "https://w3c.github.io/geolocation/reports/PR_imp_report.html", |
46 | 46 | xref: "web-platform", |
47 | | - errata: "https://w3c.github.io/geolocation-api/errata.html", |
| 47 | + errata: "https://w3c.github.io/geolocation/errata.html", |
48 | 48 | latestVersion: "https://www.w3.org/TR/geolocation/", |
49 | 49 | }; |
50 | 50 | </script> |
|
53 | 53 | "secure-contexts permissions-policy permissions hr-time html"> |
54 | 54 | <section id="abstract"> |
55 | 55 | <p> |
56 | | - The Geolocation API provides access to geographical location |
57 | | - information associated with the hosting device. |
| 56 | + Geolocation provides access to geographical location information |
| 57 | + associated with the hosting device. |
58 | 58 | </p> |
59 | 59 | </section> |
60 | 60 | <section id="sotd" class="updateable-rec"> |
|
83 | 83 | Introduction |
84 | 84 | </h2> |
85 | 85 | <p> |
86 | | - The <cite>Geolocation API</cite> defines a high-level interface to |
87 | | - location information associated only with the device hosting the |
88 | | - implementation. Common sources of location information include Global |
89 | | - Positioning System (GPS) and location inferred from network signals |
90 | | - such as IP address, RFID, WiFi and Bluetooth MAC addresses, and |
91 | | - GSM/CDMA cell IDs, as well as user input. The API itself is agnostic of |
92 | | - the underlying location information sources, and no guarantee is given |
93 | | - that the API returns the device's actual location. |
| 86 | + <cite>Geolocation</cite> defines a high-level interface to location |
| 87 | + information associated only with the device hosting the implementation. |
| 88 | + Common sources of location information include Global Positioning |
| 89 | + System (GPS) and location inferred from network signals such as IP |
| 90 | + address, RFID, WiFi and Bluetooth MAC addresses, and GSM/CDMA cell IDs, |
| 91 | + as well as user input. The API itself is agnostic of the underlying |
| 92 | + location information sources, and no guarantee is given that the API |
| 93 | + returns the device's actual location. |
94 | 94 | </p> |
95 | 95 | <p> |
96 | | - If an end user [=check permission|grants permission=], the |
97 | | - <cite>Geolocation API</cite>: |
| 96 | + If an end user [=check permission|grants permission=], |
| 97 | + <cite>Geolocation</cite>: |
98 | 98 | </p> |
99 | 99 | <ul> |
100 | 100 | <li>Provides location data as latitude, longitude, altitude, speed, and |
@@ -325,15 +325,14 @@ <h3> |
325 | 325 | </h3> |
326 | 326 | <p> |
327 | 327 | The [=policy-controlled feature/default allowlist=] of `'self'` |
328 | | - allows Geolocation API usage in same-origin nested frames but |
329 | | - prevents third-party content from using the API. |
| 328 | + allows API usage in same-origin nested frames but prevents |
| 329 | + third-party content from using the API. |
330 | 330 | </p> |
331 | 331 | <p> |
332 | 332 | Third-party usage can be selectively enabled by adding the |
333 | 333 | [^iframe/allow^]`="geolocation"` attribute to an [^iframe^] element: |
334 | 334 | </p> |
335 | | - <aside class="example" title= |
336 | | - "Enabling the Geolocation API in an iframe"> |
| 335 | + <aside class="example" title="Enabling Geolocation in an iframe"> |
337 | 336 | <pre class="html"> |
338 | 337 | <iframe |
339 | 338 | src="https://third-party.com" |
@@ -371,10 +370,10 @@ <h3> |
371 | 370 | User consent |
372 | 371 | </h3> |
373 | 372 | <p> |
374 | | - The <cite>Geolocation API</cite> is a [=powerful feature=] that |
375 | | - requires [=express permission=] from an end-user before any location |
376 | | - data is shared with a web application. This requirement is |
377 | | - normatively enforced by the [=check permission=] steps on which the |
| 373 | + <cite>Geolocation</cite> is a [=powerful feature=] that requires |
| 374 | + [=express permission=] from an end-user before any location data is |
| 375 | + shared with a web application. This requirement is normatively |
| 376 | + enforced by the [=check permission=] steps on which the |
378 | 377 | {{Geolocation/getCurrentPosition()}} and |
379 | 378 | {{Geolocation/watchPosition()}} methods rely. |
380 | 379 | </p> |
|
405 | 404 | <p class="note" title= |
406 | 405 | "Developers' responsibility with this sensitive data"> |
407 | 406 | This section applies to "recipients", which generally means |
408 | | - developers utilizing the <cite>Geolocation API</cite>. Although it's |
| 407 | + developers utilizing <cite>Geolocation</cite>. Although it's |
409 | 408 | impossible for the user agent, or this specification, to enforce |
410 | 409 | these requirements, developers need to read this section carefully |
411 | 410 | and do their best to adhere to the suggestions below. Developers need |
|
465 | 464 | Checking permission to use the API |
466 | 465 | </h2> |
467 | 466 | <p> |
468 | | - The <cite>Geolocation API</cite> is a [=default powerful feature=] |
469 | | - identified by the [=powerful feature/name=] <code><dfn class= |
| 467 | + <cite>Geolocation</cite> is a [=default powerful feature=] identified |
| 468 | + by the [=powerful feature/name=] <code><dfn class= |
470 | 469 | "permission">"geolocation"</dfn></code>. |
471 | 470 | </p> |
472 | 471 | <p> |
|
487 | 486 | Security considerations |
488 | 487 | </h2> |
489 | 488 | <p> |
490 | | - There are no security considerations associated with Geolocation API at |
491 | | - the time of publication. However, readers are advised to read the |
| 489 | + There are no security considerations associated with Geolocation at the |
| 490 | + time of publication. However, readers are advised to read the |
492 | 491 | [[[#privacy]]]. |
493 | 492 | </p> |
494 | 493 | </section> |
@@ -1238,8 +1237,8 @@ <h4> |
1238 | 1237 | </aside> |
1239 | 1238 | <aside class="addition" id="a3"> |
1240 | 1239 | <span class="marker">Candidate Correction:</span> To improve clarity |
1241 | | - and precision, a description of the accuracy attribute has been added, |
1242 | | - defining it as meters of radius. |
| 1240 | + and precision, a description of the accuracy attribute has been |
| 1241 | + added, defining it as meters of radius. |
1243 | 1242 | </aside> |
1244 | 1243 | <p> |
1245 | 1244 | <del cite="#c3">The <strong>latitude</strong> and |
@@ -1503,8 +1502,8 @@ <h2> |
1503 | 1502 | Change log |
1504 | 1503 | </h2> |
1505 | 1504 | <p> |
1506 | | - Since First Public Working Draft in 2021, the <cite>Geolocation |
1507 | | - API</cite> has received the following normative changes: |
| 1505 | + Since First Public Working Draft in 2021, <cite>Geolocation</cite> has |
| 1506 | + received the following normative changes: |
1508 | 1507 | </p> |
1509 | 1508 | <script class="removeOnSave"> |
1510 | 1509 | function removeCommits(commit) { |
@@ -1550,7 +1549,7 @@ <h2> |
1550 | 1549 | </ul> |
1551 | 1550 | <p> |
1552 | 1551 | See the <a href= |
1553 | | - "https://github.com/w3c/geolocation-api/commits/gh-pages">commit |
| 1552 | + "https://github.com/w3c/geolocation/commits/gh-pages">commit |
1554 | 1553 | history</a> for a complete list of changes. |
1555 | 1554 | </p> |
1556 | 1555 | </section> |
|
0 commit comments