ChromeOS: Add SystemTimezoneAutomaticDetection policy.

components/policy/resources/policy_templates.json

 {
 # policy_templates.json - Metafile for policy templates
 #
 # The content of this file is evaluated as a Python expression.
 #
 # This file is used as input to generate the following policy templates:
 # ADM, ADMX+ADML, MCX/plist and html documentation.
 #
 # Policy templates are user interface definitions or documents about the
 # policies that can be used to configure Chrome. Each policy is a name-value
@@ skipping 5719 matching lines @@
       'example_value': 'America/Los_Angeles',
       'id': 158,
       'caption': '''Timezone''',
       'tags': [],
       'desc': '''Specifies the timezone to be used for the device. Users can override the specified timezone for the current session. However, on logout it is set back to the specified timezone. If an invalid value is provided, the policy is still activated using "GMT" instead. If an empty string is provided, the policy is ignored.
 
       If this policy is not used, the currently active timezone will remain in use however users can change the timezone and the change is persistent. Thus a change by one user affects the login-screen and all other users.
 
       New devices start out with the timezone set to "US/Pacific".
 
-      The format of the value follows the names of timezones in the "IANA Time Zone Database" (see "https://en.wikipedia.org/wiki/Tz_database"). In particular, most timezones can be referred to by "continent/large_city" or "ocean/large_city".''',
+      The format of the value follows the names of timezones in the "IANA Time Zone Database" (see "https://en.wikipedia.org/wiki/Tz_database"). In particular, most timezones can be referred to by "continent/large_city" or "ocean/large_city".
+
+      Setting this policy completely disables automatic timezone resolve by device location. It also overrides SystemTimezoneAutomaticDetection policy.''',
     },
     {
       'name': 'SystemUse24HourClock',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome_os:30-'],
       'device_only': True,
       'features': {
         'dynamic_refresh': True,
       },
@@ skipping 2616 matching lines @@
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.*:49-','chrome_os:49-'],
       'features': {
         'dynamic_refresh': False,
         'per_profile': False,
       },
       'example_value': True,
       'tags': ['system-security'],
       'id': 324,
     },
+    {
+      'name': 'SystemTimezoneAutomaticDetection',
+      'type': 'int-enum',
+      'schema': {
+        'type': 'integer',
+        'enum': [ 0, 1, 2, 3 ],
+      },
+      'items': [
+        {
+          'name': 'AUTOMATIC_TIMEZONE_DETECTION_USERS_DECIDE',
+          'value': 0,
+          'caption': '''Let users decide.''',
+        },
+        {
+          'name': 'AUTOMATIC_TIMEZONE_DETECTION_DISABLED',
+          'value': 1,
+          'caption': '''Never auto-detect timezone.''',
+        },
+        {
+          'name': 'AUTOMATIC_TIMEZONE_DETECTION_IP_ONLY',
+          'value': 2,
+          'caption': '''Always use coarse timezone detection.''',
+        },
+        {
+          'name': 'AUTOMATIC_TIMEZONE_DETECTION_SEND_WIFI_ACCESS_POINTS',
+          'value': 3,
+          'caption': '''Always send WiFi acess-points to server.use fine-grained timezone detection (send curently visible WiFi access points to Geolocation API to better locate geographical position).''',

[bartfab (slow), 2016/04/01 14:44:50]

Nit 1: s/server.use/server and use/
Nit 2: These captions should be really, really short. Please putp lengthy
explanations in the policy 'desc' only.

[Alexander Alekseev, 2016/04/01 23:59:33]

Done.

+        },
+      ],
+      'supported_on': ['chrome_os:51-'],
+      'device_only': True,
+      'features': {
+        'dynamic_refresh': True,
+      },
+      'example_value': 0,
+      'id': 325,
+      'caption': '''Configure the automatic timezone detection method''',
+      'tags': [],

[bartfab (slow), 2016/04/01 14:44:50]

This should be tagged with "google-sharing" as
AUTOMATIC_TIMEZONE_DETECTION_SEND_WIFI_ACCESS_POINTS causes Chrome OS to send
the list of WiFi access points.

[Alexander Alekseev, 2016/04/01 23:59:33]

Done.

+      'desc': '''When this policy is set, automatic timezone detection flow will be in one of the following ways depending on the value of the setting:
+
+      If set to AUTOMATIC_TIMEZONE_DETECTION_USERS_DECIDE, users would be able to control automatic timezone detection using normal controls in chrome://settings.
+
+      If set to AUTOMATIC_TIMEZONE_DETECTION_DISABLED, automatic timezone controls in chrome://settings will be disabled. Automatic timezone detection will be always off. Timezone could be controlled either by SystemTimezone policy or by timezone selector in chrome://settings.

[bartfab (slow), 2016/04/01 14:44:50]

"Timezone could be controlled either by SystemTimezone" does not make sense here
- if SystemTimezone is set, this policy here is ignored, so its value is
irrelevant.

[Alexander Alekseev, 2016/04/01 23:59:33]

Done.

+
+      If set to AUTOMATIC_TIMEZONE_DETECTION_IP_ONLY, timezone controls in chrome://settings will be disabled. Automatic timezone detection will be always on. Timezone detection will use IP-only method to resolve location.
+
+      If set to AUTOMATIC_TIMEZONE_DETECTION_SEND_WIFI_ACCESS_POINTS, timezone controls in chrome://settings will be disabled. Automatic timezone detection will be always on. The list of visible WiFi access-points will be always sent to Geolocation API server for fine-grained timezone detection.
+
+      If this policy is not set, it will behave as if AUTOMATIC_TIMEZONE_DETECTION_USERS_DECIDE is set.
+
+      If SystemTimezone policy is set. it overrides this policy. In this case automatic timezone detection is completely disabled.''',

[bartfab (slow), 2016/04/01 14:44:50]

Nit: s/set./set,/

[Alexander Alekseev, 2016/04/01 23:59:33]

Done.

+    },
   ],
   'messages': {
     # Messages that are not associated to any policies.
     'win_supported_winxpsp2': {
       'desc': '''A label specifying the oldest possible compatible version of Windows. This text will appear right next to a label containing the text 'Supported on:'.''',
       'text': '''Microsoft Windows XP SP2 or later'''
     },
     'mac_chrome_preferences': {
       'desc': '''A text indicating in Mac OS X Workgroup Manager, that currently the preferences of Chromium are being edited''',
       'text': '''<ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> preferences'''
@@ skipping 109 matching lines @@
       'desc': '''Text appended in parentheses next to the policies top-level container to indicate that those policies are of the Recommended level''',
       'text': 'Default Settings (users can override)',
     },
     'doc_complex_policies_on_windows': {
       'desc': '''Text pointing the user to a help article for complex policies on Windows''',
       'text': '''encoded as a JSON string, for details see <ph name="COMPLEX_POLICIES_URL">https://www.chromium.org/administrators/complex-policies-on-windows<ex>https://www.chromium.org/administrators/complex-policies-on-windows</ex></ph>''',
     },
   },
   'placeholders': [],
 }