Skip to content

Sample - Population Map

This page provides a complete example of a Live Data map that shows population data for the 50 United States.

Click or touch a marker to see that state's population.

The tour above can be run standalone here:


When the map above first loads, the code shown below executes a server request to get data for all 50 states. The response from the server is handled by the code shown in the Response Handler section that follows.

function onEventPageLoaded(event) {
   let url = ``;
   event.api.liveData.requestData("json", "", url);

Response Handler

Live Data calls the code below 50 times, once for each state in the response from the server. It assigns the information about each state to the state's hotspot. A sample of the response data is shown in the next section.

function onEventLiveDataResponse(event) {
   let response = event.response;
   if (response.error) {
      alert(`Error: ${}`);
   let json =;
   event.api.setHotspotTitle(, `${}, ${}`);
   event.api.setHotspotHtml(, json.html);


The JSON objects returned for the first three of 50 states appear below.

        "id": "AL",
        "name": "Alabama",
        "capital": "Montgomery",
        "html": "<div class='state'><div><img src=''></div>
        <div class='state-census'>State population from 2020 Census</div><div class='state-population'>5,024,279</div>
        <div class='state-city'>Largest City: <strong>Huntsville</strong></div></div>"
        "id": "AK",
        "name": "Alaska",
        "capital": "Juneau",
        "html": "<div class='state'><div><img src=''></div>
        <div class='state-census'>State population from 2020 Census</div><div class='state-population'>733,391</div>
        <div class='state-city'>Largest City: <strong>Anchorage</strong></div></div>"
        "id": "AZ",
        "name": "Arizona",
        "capital": "Phoenix",
        "html": "<div class='state'><div><img src=''></div>
        <div class='state-census'>State population from 2020 Census</div><div class='state-population'>7,151,502</div>
        <div class='state-city'>Largest City: <strong>Phoenix</strong></div></div>"

Script - Python

The Python script below is used by the tour above. It handles the request for population data by reading the CSV file shown at the end of this page and returning a response as JSON. The JSON contains an html property that contains <div> tags with class names so that they can be styled using the CSS that is shown below the script.

This script is located at


import csv
import json

def handle_request():
    states = read_states()
    responses = []

    for state in states:
        html = f"<div class='state'>"\
               f"<div><img src='{state['Flag']}'></div>"\
               f"<div class='state-census'>State population from 2020 Census</div>"\
               f"<div class='state-population'>{int(state['Population']):,}</div>"\
               f"<div class='state-city'>Largest City: <strong>{state['Largest City']}</strong></div>" \

        response = {
            "id": f"{state['State']}",
            "name": f"{state['Name']}",
            "capital": f"{state['Capital']}",
            "html": html


    print("Content-Type: application/json\n")

def read_states():
    states = []

    with open('states.csv', encoding='utf-8-sig') as csv_file:
        csv_reader = csv.DictReader(csv_file)
        for index, state in enumerate(csv_reader):
    return states


CSS for Python Script

The CSS shown below styles the HTML from the Python script above. This CSS could be place in the CSS field on the tour's Custom HTML screen or in a separate .css file.

.state {
   display: flex;
   flex-direction: column;
   align-items: center;
   row-gap: 6px;

.state img {
   box-shadow: 0 2px 8px rgb(128 128 128);
   margin: 8px;

   font-size: 32px;
   font-weight: bold;
   line-height: 32px;
   margin: 2px 0;

.state-census {
   font-size: 14px;

Script - PHP

The PHP script below is not used by the tour above but is provided to show how the logic in the Python script could be implemented in PHP. Both scripts read from a CSV file, but the PHP script's response contains only data properties with no HTML. You can see the difference in responses between this script and the Python version by clicking the links for this script and the Python script. To better understand the different choices for what kind of response a script returns, see the section on using CSS and JavaScript with Live Data.

This script is located at

function handleRequest()
    $states = readStates();
    $responses = [];

    foreach ($states as $state)
        $response = new class{};
        $response->id = $state[0];
        $response->name = $state[1];
        $response->population = $state[2];
        $response->capital = $state[3];
        $response->city = $state[4];
        $response->flag = $state[5];
        $responses[] = $response;

    header('Access-Control-Allow-Origin: *');

    echo json_encode($responses);

function readStates()
    $array = [];
    if (($handle = fopen("states.csv", "r")) === false)
        return $array;

    $row = 0;
    while (($data = fgetcsv($handle)) !== false)
        if ($row >= 1)
            $array[] = $data;
        $row += 1;

    return $array;


CSV Data

The script above reads data from a CSV file. The first several rows of the file are shown below.