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 5703 matching lines @@
       'tags': [],
       'desc': '''Disables taking screenshots.
 
       If enabled screenshots cannot be taken using keyboard shortcuts or extension APIs.
 
       If disabled or not specified, taking screenshots is allowed.'''
     },
     {
       'name': 'SystemTimezone',
       'type': 'string',
-      'schema': { 'type': 'string' },
+      'schema': {
+        'type': 'object',
+        'properties': {
+          'timezone': { 'type': 'main' },

[cschuet (SLOW), 2016/03/31 08:55:21]

This should be 'type': 'int-enum'.

[Alexander Alekseev, 2016/03/31 10:24:38]

I reverted this.

+          'timezone_detection_type': {
+            'type': 'int-enum',
+            '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).''',
+              },
+            ],
+          },
+        },
+      },
       'supported_on': ['chrome_os:22-'],
       'device_only': True,
       'features': {
         'dynamic_refresh': True,
       },
       'example_value': 'America/Los_Angeles',
       'id': 158,
-      'caption': '''Timezone''',
+      'caption': '''Timezone settings''',
       '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.
+      'desc': '''This policy controls device timezone parameters.
+
+      1. |timezone| attribute 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 attribute completely disables automatic timezone resolve by device location. It also overrides |timezone_detection_type| attribute.
+
+      2. |timezone_detection_type| attribute specifies the automatic timezone detection mode.
+
+      When this attribute 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 |timezone| attribute or by timezone selector in chrome://settings.
+
+      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 attribute is not set, it will behave as if AUTOMATIC_TIMEZONE_DETECTION_USERS_DECIDE is set.
+
+      If |timezone| attribute is set. it overrides this attribute. In this case automatic timezone detection is completely disabled.''',
     },
     {
       'name': 'SystemUse24HourClock',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome_os:30-'],
       'device_only': True,
       'features': {
         'dynamic_refresh': True,
       },
@@ skipping 2745 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': [],
 }