Визуализация: GeoChart

Обзор

Геокарта — это карта страны, континента или региона с областями, обозначенными одним из трех способов:

  • Режим региона окрашивает целые регионы, такие как страны, провинции или штаты.
  • В режиме маркеров круги используются для обозначения областей, которые масштабируются в соответствии с указанным значением.
  • В текстовом режиме регионы помечаются идентификаторами (например, «Россия» или «Азия»).

Геодиаграмма отображается в браузере с использованием SVG или VML . Обратите внимание, что геодиаграмму нельзя прокручивать или перетаскивать, и это скорее линейный рисунок, чем карта местности; если вы хотите что-то из этого, рассмотрите вместо этого визуализацию карты .

Географические карты региона

Стиль regions заполняет целые регионы (обычно страны) цветами, соответствующими назначенным вами значениям.

<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <div id="regions_div" style="width: 900px; height: 500px;"></div> google.charts.load('current', { 'packages':['geochart'], }); google.charts.setOnLoadCallback(drawRegionsMap); function drawRegionsMap() { var data = google.visualization.arrayToDataTable([ ['Country', 'Popularity'], ['Germany', 200], ['United States', 300], ['Brazil', 400], ['Canada', 500], ['France', 600], ['RU', 700] ]); var options = {}; var chart = new google.visualization.GeoChart(document.getElementById('regions_div')); chart.draw(data, options); } <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <div id="regions_div" style="width: 900px; height: 500px;"></div> google.charts.load('current', { 'packages':['geochart'], }); google.charts.setOnLoadCallback(drawRegionsMap); function drawRegionsMap() { var data = google.visualization.arrayToDataTable([ ['Country', 'Popularity'], ['Germany', 200], ['United States', 300], ['Brazil', 400], ['Canada', 500], ['France', 600], ['RU', 700] ]); var options = {}; var chart = new google.visualization.GeoChart(document.getElementById('regions_div')); chart.draw(data, options); }
<html>
  <head>
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      google.charts.load('current', {
        'packages':['geochart'],
      });
      google.charts.setOnLoadCallback(drawRegionsMap);

      function drawRegionsMap() {
        var data = google.visualization.arrayToDataTable([
          ['Country', 'Popularity'],
          ['Germany', 200],
          ['United States', 300],
          ['Brazil', 400],
          ['Canada', 500],
          ['France', 600],
          ['RU', 700]
        ]);

        var options = {};

        var chart = new google.visualization.GeoChart(document.getElementById('regions_div'));

        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <div id="regions_div" style="width: 900px; height: 500px;"></div>
  </body>
</html>

Маркер GeoCharts

Стиль markers отображает круги в указанных местах на геокарте с указанными вами цветом и размером.
Попробуйте навести курсор на загроможденные маркеры вокруг Рима, и откроется увеличительное стекло, чтобы показать маркеры более подробно. (Увеличительное стекло не поддерживается в Internet Explorer версии 8 и более ранних.)

<html>
  <head>
    <script type='text/javascript' src='https://www.gstatic.com/charts/loader.js'></script>
    <script type='text/javascript'>
     google.charts.load('current', {
       'packages': ['geochart'],
       // Note: Because markers require geocoding, you'll need a mapsApiKey.
       // See: https://developers.google.com/chart/interactive/docs/basic_load_libs#load-settings
       'mapsApiKey': 'AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY'
     });
     google.charts.setOnLoadCallback(drawMarkersMap);

      function drawMarkersMap() {
      var data = google.visualization.arrayToDataTable([
        ['City',   'Population', 'Area'],
        ['Rome',      2761477,    1285.31],
        ['Milan',     1324110,    181.76],
        ['Naples',    959574,     117.27],
        ['Turin',     907563,     130.17],
        ['Palermo',   655875,     158.9],
        ['Genoa',     607906,     243.60],
        ['Bologna',   380181,     140.7],
        ['Florence',  371282,     102.41],
        ['Fiumicino', 67370,      213.44],
        ['Anzio',     52192,      43.43],
        ['Ciampino',  38262,      11]
      ]);

      var options = {
        region: 'IT',
        displayMode: 'markers',
        colorAxis: {colors: ['green', 'blue']}
      };

      var chart = new google.visualization.GeoChart(document.getElementById('chart_div'));
      chart.draw(data, options);
    };
    </script>
  </head>
  <body>
    <div id="chart_div" style="width: 900px; height: 500px;"></div>
  </body>
</html>

Отображение пропорциональных маркеров

Обычно маркерные геокарты отображают наименьшее значение маркера как минимальную точку. Если вместо этого вы хотите отобразить пропорциональные значения маркера (скажем, потому что они являются процентами), используйте параметр sizeAxis для явного задания minValue и maxValue .

Например, вот карта Западной Европы с населением и территориями трех стран: Франции, Германии и Польши. Все популяции являются абсолютными числами (например, 65 миллионов для Франции), но все площади являются процентами от целого: маркер Франции окрашен в фиолетовый цвет, потому что его население среднее, но имеет размер 50 (из возможных 100), потому что он содержит 50% общей площади.

В этом коде мы используем sizeAxis , чтобы указать размеры маркеров в диапазоне от 0 до 100. Мы также используем colorAxis со значениями RGB, чтобы показать популяции в виде диапазона цветов от оранжевого до синего, спектр, который будет хорошо работать для пользователей с недостатки цветового зрения. Наконец, мы указываем Западную Европу с region 155 в соответствии с разделом «Иерархия контента и коды» далее в этом документе.

<html>
  <head>
    <script type='text/javascript' src='https://www.gstatic.com/charts/loader.js'></script>
    <script type='text/javascript'>
     google.charts.load('current', {
       'packages': ['geochart'],
       // Note: Because markers require geocoding, you'll need a mapsApiKey.
       // See: https://developers.google.com/chart/interactive/docs/basic_load_libs#load-settings
       'mapsApiKey': 'AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY'
     });
     google.charts.setOnLoadCallback(drawMarkersMap);

      function drawMarkersMap() {
      var data = google.visualization.arrayToDataTable([
        ['Country',   'Population', 'Area Percentage'],
        ['France',  65700000, 50],
        ['Germany', 81890000, 27],
        ['Poland',  38540000, 23]
      ]);

      var options = {
        sizeAxis: { minValue: 0, maxValue: 100 },
        region: '155', // Western Europe
        displayMode: 'markers',
        colorAxis: {colors: ['#e7711c', '#4374e0']} // orange to blue
      };

      var chart = new google.visualization.GeoChart(document.getElementById('chart_div'));
      chart.draw(data, options);
    };
    </script>
  </head>
  <body>
    <div id="chart_div" style="width: 900px; height: 500px;"></div>
  </body>
</html>

Текстовые геодиаграммы

Вы можете накладывать текстовые метки на геодиаграмму с помощью displayMode: text .

Данные и параметры
  var data = google.visualization.arrayToDataTable([
    ['Country', 'Popularity'],
    ['South America', 600],
    ['Canada', 500],
    ['France', 600],
    ['Russia', 700],
    ['Australia', 600]
  ]);

  var options = { displayMode: 'text' };
Полный HTML
<html>
 <head>
  <script type='text/javascript' src="https://www.gstatic.com/charts/loader.js"></script>
  <div id="regions_div" style="width: 900px; height: 500px;"></div>

  <script type="text/javascript">
  google.charts.load('current', {
    'packages': ['geochart'],
    // Note: Because this chart requires geocoding, you'll need a mapsApiKey.
    // See: https://developers.google.com/chart/interactive/docs/basic_load_libs#load-settings
    'mapsApiKey': 'AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY'
  });
  google.charts.setOnLoadCallback(drawRegionsMap);

   function drawRegionsMap() {
     var data = google.visualization.arrayToDataTable([
       ['Country', 'Popularity'],
       ['South America', 600],
       ['Canada', 500],
       ['France', 600],
       ['Russia', 700],
       ['Australia', 600]
     ]);

     var options = { displayMode: 'text' };

     var chart = new google.visualization.GeoChart(document.getElementById('regions_div'));

     chart.draw(data, options);
   }
  </script>
 </head>
 <body>
    <div id="chart_div" style="width: 900px; height: 500px;"></div>
 </body>
</html>

Раскрашивание диаграммы

Существует несколько вариантов настройки цветов GeoCharts:

  • colorAxis : спектр цветов, используемый для областей в таблице данных.
  • backgroundColor : цвет фона диаграммы.
  • datalessRegionColor : цвет, назначаемый областям без связанных данных.
  • defaultColor : цвет, назначаемый областям в таблице данных, для которых значение равно null или не указано.

Параметр colorAxis является важным: он определяет диапазон цветов для ваших значений данных. В массиве colorAxis первый элемент — это цвет, присвоенный наименьшему значению в вашем наборе данных, а последний элемент — это цвет, присвоенный наибольшему значению в вашем наборе данных. Если указать более двух цветов, между ними произойдет интерполяция.

На следующей диаграмме мы будем использовать все четыре варианта. colorAxis используется для отображения Африки цветами панафриканского флага с использованием широты стран: от красного на севере через черный к зеленому на юге. Параметр backgroundColor используется для окрашивания фона в светло-голубой цвет, datalessRegionColor — для окрашивания неафриканских стран в светло-розовый цвет, а defaultColor для Мадагаскара.

<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <div id="geochart-colors" style="width: 700px; height: 433px;"></div> google.charts.load('current', { 'packages':['geochart'], // Note: Because this chart requires geocoding, you'll need mapsApiKey. // See: https://developers.google.com/chart/interactive/docs/basic_load_libs#load-settings 'mapsApiKey': 'AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY' }); google.charts.setOnLoadCallback(drawRegionsMap); function drawRegionsMap() { var data = google.visualization.arrayToDataTable([ ['Country', 'Latitude'], ['Algeria', 36], ['Angola', -8], ['Benin', 6], ['Botswana', -24], ['Burkina Faso', 12], ['Burundi', -3], ['Cameroon', 3], ['Canary Islands', 28], ['Cape Verde', 15], ['Central African Republic', 4], ['Ceuta', 35], ['Chad', 12], ['Comoros', -12], ['Cote d\'Ivoire', 6], ['Democratic Republic of the Congo', -3], ['Djibouti', 12], ['Egypt', 26], ['Equatorial Guinea', 3], ['Eritrea', 15], ['Ethiopia', 9], ['Gabon', 0], ['Gambia', 13], ['Ghana', 5], ['Guinea', 10], ['Guinea-Bissau', 12], ['Kenya', -1], ['Lesotho', -29], ['Liberia', 6], ['Libya', 32], ['Madagascar', null], ['Madeira', 33], ['Malawi', -14], ['Mali', 12], ['Mauritania', 18], ['Mauritius', -20], ['Mayotte', -13], ['Melilla', 35], ['Morocco', 32], ['Mozambique', -25], ['Namibia', -22], ['Niger', 14], ['Nigeria', 8], ['Republic of the Congo', -1], ['Réunion', -21], ['Rwanda', -2], ['Saint Helena', -16], ['São Tomé and Principe', 0], ['Senegal', 15], ['Seychelles', -5], ['Sierra Leone', 8], ['Somalia', 2], ['Sudan', 15], ['South Africa', -30], ['South Sudan', 5], ['Swaziland', -26], ['Tanzania', -6], ['Togo', 6], ['Tunisia', 34], ['Uganda', 1], ['Western Sahara', 25], ['Zambia', -15], ['Zimbabwe', -18] ]); var options = { region: '002', // Africa colorAxis: {colors: ['#00853f', 'black', '#e31b23']}, backgroundColor: '#81d4fa', datalessRegionColor: '#f8bbd0', defaultColor: '#f5f5f5', }; var chart = new google.visualization.GeoChart(document.getElementById('geochart-colors')); chart.draw(data, options); }; <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <div id="geochart-colors" style="width: 700px; height: 433px;"></div> google.charts.load('current', { 'packages':['geochart'], // Note: Because this chart requires geocoding, you'll need mapsApiKey. // See: https://developers.google.com/chart/interactive/docs/basic_load_libs#load-settings 'mapsApiKey': 'AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY' }); google.charts.setOnLoadCallback(drawRegionsMap); function drawRegionsMap() { var data = google.visualization.arrayToDataTable([ ['Country', 'Latitude'], ['Algeria', 36], ['Angola', -8], ['Benin', 6], ['Botswana', -24], ['Burkina Faso', 12], ['Burundi', -3], ['Cameroon', 3], ['Canary Islands', 28], ['Cape Verde', 15], ['Central African Republic', 4], ['Ceuta', 35], ['Chad', 12], ['Comoros', -12], ['Cote d\'Ivoire', 6], ['Democratic Republic of the Congo', -3], ['Djibouti', 12], ['Egypt', 26], ['Equatorial Guinea', 3], ['Eritrea', 15], ['Ethiopia', 9], ['Gabon', 0], ['Gambia', 13], ['Ghana', 5], ['Guinea', 10], ['Guinea-Bissau', 12], ['Kenya', -1], ['Lesotho', -29], ['Liberia', 6], ['Libya', 32], ['Madagascar', null], ['Madeira', 33], ['Malawi', -14], ['Mali', 12], ['Mauritania', 18], ['Mauritius', -20], ['Mayotte', -13], ['Melilla', 35], ['Morocco', 32], ['Mozambique', -25], ['Namibia', -22], ['Niger', 14], ['Nigeria', 8], ['Republic of the Congo', -1], ['Réunion', -21], ['Rwanda', -2], ['Saint Helena', -16], ['São Tomé and Principe', 0], ['Senegal', 15], ['Seychelles', -5], ['Sierra Leone', 8], ['Somalia', 2], ['Sudan', 15], ['South Africa', -30], ['South Sudan', 5], ['Swaziland', -26], ['Tanzania', -6], ['Togo', 6], ['Tunisia', 34], ['Uganda', 1], ['Western Sahara', 25], ['Zambia', -15], ['Zimbabwe', -18] ]); var options = { region: '002', // Africa colorAxis: {colors: ['#00853f', 'black', '#e31b23']}, backgroundColor: '#81d4fa', datalessRegionColor: '#f8bbd0', defaultColor: '#f5f5f5', }; var chart = new google.visualization.GeoChart(document.getElementById('geochart-colors')); chart.draw(data, options); };
Опции
        var options = {
          region: '002', // Africa
          colorAxis: {colors: ['#00853f', 'black', '#e31b23']},
          backgroundColor: '#81d4fa',
          datalessRegionColor: '#f8bbd0',
          defaultColor: '#f5f5f5',
        };
Полная веб-страница
<html>
  <head>
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      google.charts.load('current', {
        'packages':['geochart'],
        // Note: Because this chart requires geocoding, you'll need mapsApiKey.
        // See: https://developers.google.com/chart/interactive/docs/basic_load_libs#load-settings
        'mapsApiKey': 'AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY'
      });
      google.charts.setOnLoadCallback(drawRegionsMap);

      function drawRegionsMap() {
        var data = google.visualization.arrayToDataTable([
          ['Country',   'Latitude'],
          ['Algeria', 36], ['Angola', -8], ['Benin', 6], ['Botswana', -24],
          ['Burkina Faso', 12], ['Burundi', -3], ['Cameroon', 3],
          ['Canary Islands', 28], ['Cape Verde', 15],
          ['Central African Republic', 4], ['Ceuta', 35], ['Chad', 12],
          ['Comoros', -12], ['Cote d\'Ivoire', 6],
          ['Democratic Republic of the Congo', -3], ['Djibouti', 12],
          ['Egypt', 26], ['Equatorial Guinea', 3], ['Eritrea', 15],
          ['Ethiopia', 9], ['Gabon', 0], ['Gambia', 13], ['Ghana', 5],
          ['Guinea', 10], ['Guinea-Bissau', 12], ['Kenya', -1],
          ['Lesotho', -29], ['Liberia', 6], ['Libya', 32], ['Madagascar', null],
          ['Madeira', 33], ['Malawi', -14], ['Mali', 12], ['Mauritania', 18],
          ['Mauritius', -20], ['Mayotte', -13], ['Melilla', 35],
          ['Morocco', 32], ['Mozambique', -25], ['Namibia', -22],
          ['Niger', 14], ['Nigeria', 8], ['Republic of the Congo', -1],
          ['Réunion', -21], ['Rwanda', -2], ['Saint Helena', -16],
          ['São Tomé and Principe', 0], ['Senegal', 15],
          ['Seychelles', -5], ['Sierra Leone', 8], ['Somalia', 2],
          ['Sudan', 15], ['South Africa', -30], ['South Sudan', 5],
          ['Swaziland', -26], ['Tanzania', -6], ['Togo', 6], ['Tunisia', 34],
          ['Uganda', 1], ['Western Sahara', 25], ['Zambia', -15],
          ['Zimbabwe', -18]
        ]);

        var options = {
          region: '002', // Africa
          colorAxis: {colors: ['#00853f', 'black', '#e31b23']},
          backgroundColor: '#81d4fa',
          datalessRegionColor: '#f8bbd0',
          defaultColor: '#f5f5f5',
        };

        var chart = new google.visualization.GeoChart(document.getElementById('geochart-colors'));
        chart.draw(data, options);
      };
    </script>
  </head>
  <body>
    <div id="geochart-colors" style="width: 700px; height: 433px;"></div>
  </body>
</html>

Загрузка

Имя пакета google.charts.load"geochart" . Обратите внимание, что вам не следует копировать наш mapsApiKey; это не сработает. Пока ваша диаграмма не требует геокодирования или использования нестандартных кодов для определения местоположений, вам не нужен mapsApiKey. Дополнительные сведения см. в разделе Загрузить настройки .

  google.charts.load('current', {
    'packages': ['geochart'],
    // Note: if your chart requires geocoding or uses nonstandard codes, you'll
    // need to get a mapsApiKey for your project. The one below won't work.
    // See: https://developers.google.com/chart/interactive/docs/basic_load_libs#load-settings
    'mapsApiKey': 'AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY'
  });

Имя класса визуализации геодиаграммы — google.visualization.GeoChart .

  var visualization = new google.visualization.GeoChart(container);

Формат данных

Формат DataTable зависит от того, какой режим отображения вы используете: regions , markers или text .

Формат режима регионов

Местоположение вводится в один столбец плюс один необязательный столбец, как описано здесь:

  1. Местоположение региона [ строка, обязательно ] — регион для выделения. Принимаются все следующие форматы. Вы можете использовать разные форматы в разных строках:
    • Название страны в виде строки (например, «Англия»), код ISO-3166-1 alpha-2 в верхнем регистре или его эквивалент на английском языке (например, «GB» или «United Kingdom»).
    • Кодовое название региона ISO-3166-2 в верхнем регистре или его эквивалент на английском языке (например, «US-NJ» или «New Jersey»).
    • Код города . Это трехзначные коды метро, ​​​​используемые для обозначения различных регионов; Поддерживаются только коды США. Обратите внимание, что это не то же самое, что телефонные коды городов.
    • Любое значение, поддерживаемое свойством region .
  2. Цвет области [ число, необязательный ] — необязательный числовой столбец, используемый для назначения цвета этой области на основе шкалы, указанной в свойстве colorAxis.colors . Если этого столбца нет, все регионы будут одного цвета. Если столбец присутствует, нулевые значения не допускаются. Значения масштабируются относительно значений sizeAxis.minValue / sizeAxis.maxValue или значений, указанных в свойстве colorAxis.values , если оно предоставлено.

Формат режима маркеров

Количество столбцов зависит от используемого формата маркера, а также от других необязательных столбцов.

  • Расположение маркера [ обязательно ]
    Первый столбец — это конкретный строковый адрес (например, «1600 Pennsylvania Ave»).

    ИЛИ ЖЕ

    Первые два столбца являются числовыми, где первый столбец — это широта, а второй — долгота.

    Примечание. Хотя мы рекомендуем использовать коды ISO 3166 для режима «регионы», режим «маркеры» лучше всего работает с более длинными названиями регионов (например, Германия, Панама и т. д.). Это связано с тем, что геокарты в режиме «маркеров» используют Карты Google для геокодирования местоположений (преобразование строкового местоположения в широту и долготу). Это может привести к тому, что неоднозначные местоположения не будут геокодированы, как вы могли бы ожидать; например, «DE» означает Германию или Делавэр, или «PA» означает Панаму или Пенсильванию.

  • Цвет маркера [ число, необязательный ] Следующий столбец — это необязательный числовой столбец, используемый для назначения цвета этому маркеру на основе шкалы, указанной в свойстве colorAxis.colors . Если этого столбца нет, все маркеры будут одного цвета. Если столбец присутствует, нулевые значения не допускаются. Значения масштабируются относительно друг друга или абсолютно по значениям, указанным в свойстве colorAxis.values .
  • Размер маркера [ Число, необязательный ] Необязательный числовой столбец, используемый для назначения размера маркера относительно других размеров маркеров. Если этот столбец отсутствует, будет использоваться значение из предыдущего столбца (или размер по умолчанию, если также не указан столбец цвета). Если столбец присутствует, нулевые значения не допускаются.

Формат текстового режима

Метка вводится в первый столбец плюс один необязательный столбец:

  • Текстовая метка [ строка , обязательно ] Конкретный строковый адрес (например, «1600 Pennsylvania Ave»).
  • Размер текста [ число, необязательный ] Второй столбец является необязательным числовым столбцом, используемым для назначения размера метки. Если этот столбец отсутствует, все метки будут одинакового размера.

Варианты конфигурации

Имя
фоновый цвет

Цвет фона для основной области диаграммы. Может быть либо простой строкой цвета HTML, например: 'red' или '#00cc00' , либо объектом со следующими свойствами.

Тип: строка или объект
По умолчанию: белый
backgroundColor.fill

Цвет заливки диаграммы в виде строки цвета HTML.

Тип: строка
По умолчанию: белый
backgroundColor.stroke

Цвет границы диаграммы в виде строки цвета HTML.

Тип: строка
По умолчанию: '#666'
backgroundColor.strokeWidth

Ширина границы в пикселях.

Тип: номер
По умолчанию: 0
цветОсь

Объект, указывающий сопоставление между значениями столбца цвета и цветами или шкалой градиента. Чтобы указать свойства этого объекта, вы можете использовать литеральную нотацию объекта, как показано здесь:

 {minValue: 0,  colors: ['#FF0000', '#00FF00']}
Тип: объект
По умолчанию: ноль
colorAxis.minValue

Если присутствует, указывает минимальное значение для данных цвета диаграммы. Значения цветовых данных этого значения и ниже будут отображаться как первый цвет в диапазоне colorAxis.colors .

Тип: номер
По умолчанию: минимальное значение столбца цвета в данных диаграммы.
colorAxis.maxValue

Если присутствует, задает максимальное значение для данных цвета диаграммы. Значения цветовых данных этого значения и выше будут отображаться как последний цвет в диапазоне colorAxis.colors .

Тип: номер
По умолчанию: максимальное значение столбца цвета в данных диаграммы.
colorAxis.значения

Если присутствует, управляет тем, как значения связаны с цветами. Каждое значение связано с соответствующим цветом в массиве colorAxis.colors . Эти значения применяются к данным цвета диаграммы. Окрашивание выполняется в соответствии с градиентом значений, указанных здесь. Отсутствие указания значения для этой опции эквивалентно указанию [minValue, maxValue].

Тип: массив чисел
По умолчанию: ноль
colorAxis.colors

Цвета для назначения значениям в визуализации. Массив строк, где каждый элемент представляет собой строку цвета HTML, например: colorAxis: {colors:['red','#004411']} . У вас должно быть как минимум два значения; градиент будет включать все ваши значения, а также рассчитанные промежуточные значения, причем первый цвет будет наименьшим значением, а последний цвет — максимальным.

Тип: массив цветных строк
По умолчанию: ноль
без данныхRegionColor

Цвет для назначения областям без связанных данных.

Тип: строка
По умолчанию: '#F5F5F5'
по умолчаниюЦвет

Цвет, используемый для точек данных на геодиаграмме, когда местоположение (например, 'US' ) присутствует, но значение равно null или не указано. Это отличается от datalessRegionColor , который используется при отсутствии данных.

Тип: строка
По умолчанию: «# 267114».
Режим отображения

Какой это тип геокарты. Формат DataTable должен соответствовать указанному значению. Поддерживаются следующие значения:

  • «авто» — выберите на основе формата DataTable.
  • 'regions' - Цвет регионов на геокарте.
  • 'markers' - Разместите маркеры на регионах.
  • 'text' — пометьте регионы текстом из DataTable.
Тип: строка
По умолчанию: «авто»
домен

Покажите геокарту так, как если бы она обслуживалась из этого региона. Например, при установке domain 'IN' Кашмир будет отображаться как принадлежащий Индии, а не как спорная территория.

Тип: строка
По умолчанию: ноль
включитьрегионинтерактивность

Если задано значение true, включите интерактивность области, в том числе выделение фокуса и всплывающую подсказку при наведении мыши, а также выбор области и срабатывание событий regionClick и select при щелчке мыши.

Значение по умолчанию — true в режиме региона и false в режиме маркера.

Тип: логический
По умолчанию: автоматически
ForceIFrame

Рисует диаграмму внутри встроенного фрейма. (Обратите внимание, что в IE8 этот параметр игнорируется; все диаграммы IE8 отображаются в i-фреймах.)

Тип: логический
По умолчанию: ложь
версия геокарты

Версия данных границ GeoChart. Доступны версии 10 и 11 .

Тип: номер
По умолчанию: 10
высота

Высота визуализации в пикселях. Высота по умолчанию составляет 347 пикселей, если не указан параметр width и для параметра keepAspectRatio задано значение true — в этом случае высота рассчитывается соответствующим образом.

Тип: номер
По умолчанию: авто
сохранять пропорции

Если true, геокарта будет нарисована с максимальным размером, который может поместиться внутри области диаграммы при ее естественном соотношении сторон. Если указан только один из параметров width и height , другой будет рассчитан в соответствии с соотношением сторон.

Если false, географическая диаграмма будет растянута до точного размера диаграммы, как указано параметрами width и height .

Тип: логический
По умолчанию: правда
легенда

Объект с элементами для настройки различных аспектов легенды или «нет», если легенда не должна отображаться. Чтобы указать свойства этого объекта, вы можете использовать литеральную нотацию объекта, как показано здесь:

 {textStyle: {color: 'blue', fontSize: 16}}
Тип: Объект / 'нет'
По умолчанию: ноль
legend.numberFormat

Строка формата для числовых меток. Это подмножество набора шаблонов ICU . Например, {numberFormat:'.##'} будет отображать значения "10,66", "10,6" и "10,0" для значений 10,666, 10,6 и 10.

Тип: строка
По умолчанию: авто
легенда.textStyle

Объект, определяющий стиль текста легенды. Объект имеет следующий формат:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color может быть любой строкой цвета HTML, например: 'red' или '#00cc00' . Также см. fontName и fontSize .

Тип: объект
По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
область, край

Область для отображения на геокарте. (Также будут отображаться окружающие области.) Может быть одним из следующих:

  • 'мир' - геокарта всего мира.
  • Континент или субконтинент, определяемый трехзначным кодом , например "011" для Западной Африки.
  • Страна, определяемая кодом ISO 3166-1 alpha-2 , например, «AU» для Австралии.
  • Штат в Соединенных Штатах, определяемый его кодом ISO 3166-2:US , например, «US-AL» для Алабамы. Обратите внимание, что параметр resolution должен быть установлен либо на «провинциях», либо на «метро».
Тип: строка
По умолчанию: «мир»
увеличительное стекло

Объект с членами для настройки различных аспектов увеличительного стекла. Чтобы указать свойства этого объекта, вы можете использовать литеральную нотацию объекта, как показано здесь:

{enable: true, zoomFactor: 7.5}
Тип: Объект
По умолчанию: {enable: true, zoomFactor: 5.0}
увеличительное стекло.enable

Если это правда, когда пользователь задерживается на загроможденном маркере, открывается увеличительное стекло.

Примечание: эта функция не поддерживается в браузерах, не поддерживающих SVG , например Internet Explorer версии 8 или более ранней.

Тип: логический
По умолчанию: правда
увеличительное стекло. zoomFactor

Коэффициент масштабирования увеличительного стекла. Может быть любым числом больше 0.

Тип: номер
По умолчанию: 5.0
маркерНепрозрачность

Непрозрачность маркеров, где 0.0 — полностью прозрачный, а 1.0 — полностью непрозрачный.

Тип: число, 0,0–1,0
По умолчанию: 1,0
RegioncoderVersion

Версия данных региона. Доступны версии 0 и 1 .

Тип: номер
По умолчанию: 0
разрешающая способность

Разрешение границ геокарты. Выберите одно из следующих значений:

  • «страны» — поддерживается для всех регионов, кроме регионов штатов США.
  • «провинция» — поддерживается только для регионов страны и регионов США. Поддерживается не во всех странах; пожалуйста, проверьте страну, чтобы увидеть, поддерживается ли эта опция.
  • 'metros' — поддерживается только для региона страны США и регионов штата США.
Тип: строка
По умолчанию: «страны»
размерОсь

Объект с членами для настройки того, как значения связаны с размером пузырька. Чтобы указать свойства этого объекта, вы можете использовать литеральную нотацию объекта, как показано здесь:

 {minValue: 0,  maxSize: 20}
Тип: объект
По умолчанию: ноль
sizeAxis.maxSize

Максимальный радиус максимально возможного пузырька в пикселях.

Тип: номер
По умолчанию: 12
sizeAxis.maxValue

Значение размера (как показано в данных диаграммы), которое должно быть сопоставлено с sizeAxis.maxSize . Большие значения будут обрезаны до этого значения.

Тип: номер
По умолчанию: максимальное значение столбца размера в данных диаграммы.
размерAxis.minSize

Минимальный радиус наименьшего возможного пузырька в пикселях.

Тип: номер
По умолчанию: 3
sizeAxis.minValue

Значение размера (как показано в данных диаграммы), которое должно быть сопоставлено с sizeAxis.minSize . Меньшие значения будут обрезаны до этого значения.

Тип: номер
По умолчанию: минимальное значение столбца размера в данных диаграммы.
подсказка

Объект с членами для настройки различных элементов всплывающей подсказки. Чтобы указать свойства этого объекта, вы можете использовать литеральную нотацию объекта, как показано здесь:

{textStyle: {color: '#FF0000'}, showColorCode: true}
Тип: объект
По умолчанию: ноль
tooltip.textStyle

Объект, определяющий стиль текста всплывающей подсказки. Объект имеет следующий формат:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color может быть любой строкой цвета HTML, например: 'red' или '#00cc00' . Также см. fontName и fontSize .

Тип: объект
По умолчанию: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
всплывающая подсказка.триггер

Взаимодействие с пользователем, вызывающее отображение всплывающей подсказки:

  • «фокус» — всплывающая подсказка будет отображаться, когда пользователь наводит курсор на элемент.
  • 'none' - всплывающая подсказка не будет отображаться.
  • «выбор» — всплывающая подсказка будет отображаться, когда пользователь выбирает элемент.
Тип: строка
По умолчанию: «фокус».
ширина

Ширина визуализации в пикселях. Ширина по умолчанию составляет 556 пикселей, если не указан параметр height , а для параметра keepAspectRatio задано значение true — в этом случае ширина рассчитывается соответствующим образом.

Тип: номер
По умолчанию: авто

Континентальная иерархия и коды

Можно отобразить геокарты континентов/субконтинентов, установив для параметра region один из следующих трехзначных кодов. Коды и иерархия основаны, за некоторыми исключениями, на кодах, разработанных и поддерживаемых Статистическим отделом Организации Объединенных Наций .

Континент субконтинент Страны
002 - Африка 015 - Северная Африка DZ , EG , EH , LY , MA , SD , SS , TN
011 - Западная Африка BF , BJ , CI , CV , GH , GM , GN , GW , LR , ML , MR , NE , NG , SH , SL , SN , TG
017 - Средняя Африка АО , CD , ZR , CF , CG , CM , GA , GQ , ST , TD
014 - Восточная Африка БИ , ДДЖ , ЭР , ЭТ , КЭ , КМ , МГ , МУ , МВТ , МЗ , РЭ , РВ , СК , ТАК , ТЗ , УГ , ЮТ , ЗМ , ЗВ
018 - Южная Африка ЧБ , ЛС , Н.А. , СЗ , ЗА
150 - Европа 154 - Северная Европа GG , JE , AX , DK , EE , FI , FO , GB , IE , IM , IS , LT , LV , NO , SE , SJ
155 - Западная Европа AT , BE , CH , DE , DD , FR , FX , LI , LU , MC , NL
151 - Восточная Европа BG , BY , CZ , HU , MD , PL , RO , RU , SU , SK , UA
039 - Южная Европа АД , АЛ , БА , ЭС , ГИ , ГР , ЧР , ИТ , МЭ , МК , МТ , РС , ПТ , СИ , СМ , ВА , Ю
019 - Америка 021 - Северная Америка БМ , Калифорния , GL , PM , США
029 - Карибский бассейн AG , AI , AN , AW , BB , BL , BS , CU , DM , DO , GD , GP , HT , JM , KN , KY , LC , MF , MQ , MS , PR , TC , TT , VC , VG , VI
013 - Центральная Америка БЗ , КР , ГТ , ХН , МС , НИ , ПА , СВ
005 - Южная Америка AR , BO , BR , CL , CO , EC , FK , GF , GY , PE , PY , SR , UY , VE
142 - Азия 143 - Средняя Азия ТМ , ТДЖ , КГ , КЗ , УЗ
030 - Восточная Азия КН , ХК , ДЖП , КП , КР , МН , МО , ТВ
034 - Южная Азия АФ , БД , БТ , ИН , ИК , ЛК , МВ , НП , ПК
035 - Юго-Восточная Азия БН , ИД , КХ , ЛА , ММ , БУ , МОЙ , РН , СГ , ТХ , ТЛ , ТП , ВН
145 - Западная Азия AE , AM , AZ , BH , CY , GE , IL , IQ , JO , KW , LB , OM , PS , QA , SA , NT , SY , TR , YE , YD
009 - Океания 053 - Австралия и Новая Зеландия Австралия , Новая Зеландия , Новая Зеландия
054 - Меланезия ФД , НК , ПГ , СБ , ВУ
057 - Микронезия FM , ГУ , КИ , МЗ , МП , НР , ПВ
061 - Полинезия КАК , ЧК , НУ , ПФ , ПН , ТК , ТО , ТВ , ВФ , ВС

Методы

Метод
clearChart()

Очищает диаграмму и освобождает все выделенные ей ресурсы.

Тип возврата: нет
draw(data, options)

Рисует график. Диаграмма принимает дальнейшие вызовы методов только после запуска события ready . Extended description .

Тип возврата: нет
getImageURI()

Возвращает диаграмму, сериализованную как URI изображения.

Вызовите это после того, как диаграмма будет нарисована.

См. Печать диаграмм PNG .

Тип возвращаемого значения: строка
getSelection()

Возвращает массив выбранных объектов диаграммы. Выбираемые объекты — это регионы с присвоенным значением. Для этой диаграммы в любой момент можно выбрать только один объект. Extended description .

Тип возвращаемого значения: Массив элементов выбора
setSelection()

Выбирает указанные объекты диаграммы. Отменяет любой предыдущий выбор. Выбираемые объекты — это регионы с присвоенным значением. Для этой диаграммы одновременно может быть выбран только один объект. Extended description .

Тип возврата: нет

События

Имя
error

Запускается, когда возникает ошибка при попытке отобразить диаграмму.

Свойства: идентификатор, сообщение
ready

Диаграмма готова к вызову внешних методов. Если вы хотите взаимодействовать с диаграммой и вызывать методы после ее рисования, вы должны настроить прослушиватель для этого события до вызова метода draw и вызывать их только после того, как событие было запущено.

Свойства: нет
regionClick

Вызывается при щелчке области. Это не будет выбрано для конкретной страны, назначенной в опции «регион» (если указана конкретная страна).

Свойства: объект с одним свойством, region , который представляет собой строку в формате ISO-3166, описывающую выбранную область.
select

Запускается, когда пользователь щелкает визуальный объект. Чтобы узнать, что было выбрано, вызовите getSelection() .

Свойства: нет

Политика данных

Местоположение геокодировано Google Maps. Любые данные, не требующие геокодирования, не отправляются ни на какой сервер. Пожалуйста, ознакомьтесь с Условиями использования Google Maps для получения дополнительной информации об их политике в отношении данных.