Products

• Local Lifestyle Widget
• Local Lifestyle API
• Demographics API
• Crime Widget
• Proximitii Maps

Authentication

In order to use any of the Proximitii products, you will need a key. The keys will authenticate your access to the widgets or API. We have two different types of authentication, depending on which product is being called.

Public Key (Widget):

When using a widget, you’ll be asked for the URL of the website you want to put it on, and given a public key in return. Use this public key in your widget, and as long as it’s installed on the correct site, the key will work.

Private Key (API):

When using the API, a public key and a private key is required to authenticate the API. Send these together in your API calls. Do not expose the private key in code or on publicly viewable endpoints.

If you do not have a key, please contact info@proximitii.com.

Service Areas

These are the areas that we currently cover:

Installation

Add the following embed code to your page or template. In order for the widget to render, you must add your own public key and you must pass the latitude and longitude.

<script src="https://widget-api.proximitii.com/proximitii-embed.js?v=2.0.2"></script>
<div id="prox-map"></div>
<script type="module">
window.onProximitiiLoad = () => {
let proximitiiMap = new Proximitii('prox-map')

//Make sure to put in your own public key!
proximitiiMap.setPublicKey("YOUR OWN KEY HERE")

proximitiiMap.setCenter(43.66068291135164, -79.34739798021833)

proximitiiMap.setOptions({
    primaryColor: '#607EB8',   
    titleSize: '22px',
    hideScores: false, 
    hideTitle: false, 
    hideRadius: false, 
    hideBackgroundImage: false, 
    markerIconColor: 'white',
    language: 'en',
    height: '500px',
    customOrderCategories: false,
    disableGestureHandling: false
})

proximitiiMap.setColors({
    scoreCircle: "primary",
    locationMarker: "primary",
})

proximitiiMap.render()
}
</script>

How to Install the Widget:

First, start by importing the Proximitii script.

<script src="https://widget-api.proximitii.com/proximitii-embed.js"></script>

And a div for the map to fill.

<div id="prox-map"></div>

Next, you can access the onProximitiiLoad function and pass in a callback, where you create a new instance of Proximitii.

<div id="prox-map"></div>
<script type="module">
window.onProximitiiLoad = () => {
    let proximitiiMap = new Proximitii('prox-map')

    //Make sure to put in your own public key!
    proximitiiMap.setPublicKey('KEY')

    proximitiiMap.setCenter(44.656834, -63.5982224)

    proximitiiMap.render()
}
</script>

You can also set and reset options, including the center, at any time, if you call render after. Various colors may also be changed.

proximitiiMap.setOptions({
        primaryColor: '#02a0e9', 
        title: 'Proximitii Score',
        hideScores: false, 
        hideTitle: false, 
        hideRadius: false, 
        hideBackgroundImage: false, 
        markerIconColor: 'white',
	language: 'en',
        height: '500px',
        sortCategoriesScore: false,
        gestureHandling: false
    })
    
proximitiiMap.setColors({
        scoreCircle: "#189CAD",
        locationMarker: "#537BBE",
        link: "#02a0e9",
        categoryScore: "primary",
        categoryScoreText: "#ffffff"
    })

Always be sure to call render AFTER setting or resetting any options.

Customization

There are many customization options. See below for how to customize the widget.

General Options:

Display Options:

Color Options:

Tech Options:

Categories

These are the categories that are available in the Local Lifestyle Widget.

WordPress

To install the Local Lifestyle Widget on WordPress, please see the instructions below.

Install:

1. Download the plugin from here, it’s a zip file
2. Navigate to your WordPress dashboard, and go to “Plugins”
3. Click “Add New”
4. On the next page click “Upload Plugin” > “Choose File”
5. Navigate to your downloads, and upload the package
6. Click “Install”
7. Go back to your list of Plugins, and find the Proximitii Widget plugin- click the “Activate” button underneath
8. You should now see “Proximitii Widget” on your sidebar- click on that.
9. Fill out settings. These are your default settings for your whole website- anytime you update here, it will update all widgets on your site automatically.

Shortcodes:

1. You can use the widget anywhere on your WordPress site you can use shortcodes - [proximitii]
2. The bare minimum you’ll need to pass in the latitude and longitude as parameters, like this - [proximitii latitude=”xx” longitude=”yy”]
3. You can also override any settings you set on the settings page in each shortcode - [proximitii latitude=”xx” longitude=”yy” titleSize=”32px”]
4. You can use The Playground page to generate shortcodes

Example Calls

node.js

const url = 'https://widget-api.proximitii.com/api/map/locations?lat=43.659251&long=-79.345218&dataType=all&radius=6400&limit=2&categories=coffee,park,elem';
const options = {
  method: 'GET',
  headers: {
    'public_key': '{public_key}',
    'private_key': '{private_key}'
  }
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://widget-api.proximitii.com/api/map/locations?lat=43.659251&long=-79.345218&dataType=all&radius=6400&limit=2&categories=coffee,park,elem',
  CURLOPT_HTTPHEADER => [
    'public_key: {public_key}',
    'private_key: {private_key}'
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

Keys

In order to call the API successfully, you will need a public and private key. Make sure to store the keys safely and call the API on the backend so the keys are not exposed to the public.

Values

Categories:

Sample Output

{
    "OverallScore": 94,
    "Data": {
        "Walkability": {
            "Category": "Walkability",
            "Score": 10,
            "Text": "Highly walkable with lots of daily essentials nearby."
        },
        "Active Living": {
            "Category": "Active Living",
            "Score": 10,
            "Text": "Great access to wellness, fitness, and outdoor spaces."
        },
        "Education": {
            "Category": "Education",
            "Score": 9,
            "Text": "Excellent education options close by and easy to reach."
        },
        "Transit Access": {
            "Category": "Transit Access",
            "Score": 9,
            "Text": "Excellent transit access with plenty of options nearby."
        },
        "coffee": {
            "Category": "coffee",
            "Score": 10,
            "Count": 5,
            "Locations": [
                {
                    "AmenityID": "29295",
                    "Name": "Starbucks",
                    "Address": " ",
                    "Category": "coffee",
                    "Dist": 245,
                    "Tag": "Coffee Shop",
                    "District": null,
                    "WalkingTime": 4,
                    "Coord": {
                        "Lat": 43.6603708,
                        "Long": -79.3425969
                    }
                },
                {
                    "AmenityID": "14002",
                    "Name": "Purple Penguin Cafe",
                    "Address": "889 Queen Street East",
                    "Category": "coffee",
                    "Dist": 271,
                    "Tag": "Coffee Shop",
                    "District": null,
                    "WalkingTime": 4,
                    "Coord": {
                        "Lat": 43.6604252,
                        "Long": -79.3422613
                    }
                },
                {
                    "AmenityID": "26668",
                    "Name": "Starbucks",
                    "Address": " ",
                    "Category": "coffee",
                    "Dist": 289,
                    "Tag": "Coffee Shop",
                    "District": null,
                    "WalkingTime": 5,
                    "Coord": {
                        "Lat": 43.6607025,
                        "Long": -79.3422363
                    }
                },
                {
                    "AmenityID": "25207",
                    "Name": "The Dock",
                    "Address": "932 Queen Street East",
                    "Category": "coffee",
                    "Dist": 346,
                    "Tag": "Coffee Shop",
                    "District": null,
                    "WalkingTime": 6,
                    "Coord": {
                        "Lat": 43.6608715,
                        "Long": -79.3415515
                    }
                },
                {
                    "AmenityID": "4373",
                    "Name": "Mercury Espresso",
                    "Address": "915 Queen Street East",
                    "Category": "coffee",
                    "Dist": 347,
                    "Tag": "Coffee Shop",
                    "District": null,
                    "WalkingTime": 6,
                    "Coord": {
                        "Lat": 43.660667,
                        "Long": -79.3413718
                    }
                }
            ]
        },
        "park": {
            "Category": "park",
            "Score": 10,
            "Count": 5,
            "Locations": [
                {
                    "AmenityID": "1142535",
                    "Name": null,
                    "Address": null,
                    "Category": "park",
                    "Dist": 15,
                    "Tag": "Playground",
                    "District": null,
                    "WalkingTime": 1,
                    "Coord": {
                        "Lat": 43.6592602297925,
                        "Long": -79.3454005968036
                    }
                },
                {
                    "AmenityID": "1000098",
                    "Name": "McCleary Playground",
                    "Address": "80 McGee Street",
                    "Category": "park",
                    "Dist": 17,
                    "Tag": "Park",
                    "District": null,
                    "WalkingTime": 1,
                    "Coord": {
                        "Lat": 43.6593088127695,
                        "Long": -79.3454086596916
                    }
                },
                {
                    "AmenityID": "1009659",
                    "Name": "Saulter Street Parkette",
                    "Address": "25 Saulter Street",
                    "Category": "park",
                    "Dist": 200,
                    "Tag": "Park",
                    "District": null,
                    "WalkingTime": 3,
                    "Coord": {
                        "Lat": 43.6577088206208,
                        "Long": -79.3465032129895
                    }
                },
                {
                    "AmenityID": "858978",
                    "Name": "Jimmie Simpson Park",
                    "Address": "870 Queen Street East",
                    "Category": "park",
                    "Dist": 222,
                    "Tag": "Park",
                    "District": null,
                    "WalkingTime": 4,
                    "Coord": {
                        "Lat": 43.6612131263222,
                        "Long": -79.3447192120837
                    }
                },
                {
                    "AmenityID": "906145",
                    "Name": "Bruce Mackey Park",
                    "Address": "55 Wardell Street",
                    "Category": "park",
                    "Dist": 327,
                    "Tag": "Park",
                    "District": null,
                    "WalkingTime": 5,
                    "Coord": {
                        "Lat": 43.6621705282381,
                        "Long": -79.3457540944358
                    }
                }
            ]
        },
        "elem": {
            "Category": "elem",
            "Score": 9,
            "Count": 4,
            "Locations": [
                {
                    "NCESDistrictID": null,
                    "AmenityID": "153214-CA",
                    "Name": "Dundas Junior Public School",
                    "Address": "935 Dundas St E",
                    "Category": "elem",
                    "Dist": 416,
                    "Tag": "Elementary",
                    "District": null,
                    "LowGrade": "JK",
                    "HighGrade": "5",
                    "SchoolScore": "74.5",
                    "Site": "http:\/\/schoolweb.tdsb.on.ca\/dundas",
                    "City": "Toronto",
                    "StateAbbr": "ON",
                    "ZIP": "M4M 1R4",
                    "Phone": "416-393-9565",
                    "IsPre": "0",
                    "IsElem": "1",
                    "IsMid": "0",
                    "IsHigh": "0",
                    "ProfMath": "67",
                    "ProfLang": "82",
                    "WalkingTime": 7,
                    "Coord": {
                        "Lat": 43.6620635986328,
                        "Long": -79.3486251831055
                    },
                    "Assigned": false
                },
                {
                    "NCESDistrictID": null,
                    "AmenityID": "374733-CA",
                    "Name": "Morse Street Junior Public School",
                    "Address": "180 Carlaw Ave",
                    "Category": "elem",
                    "Dist": 420,
                    "Tag": "Elementary",
                    "District": null,
                    "LowGrade": "JK",
                    "HighGrade": "6",
                    "SchoolScore": "71.5",
                    "Site": "http:\/\/schoolweb.tdsb.on.ca\/morsestreet",
                    "City": "Toronto",
                    "StateAbbr": "ON",
                    "ZIP": "M4M 2R9",
                    "Phone": "416-393-9494",
                    "IsPre": "0",
                    "IsElem": "1",
                    "IsMid": "0",
                    "IsHigh": "0",
                    "ProfMath": "57",
                    "ProfLang": "86",
                    "WalkingTime": 7,
                    "Coord": {
                        "Lat": 43.6601181030273,
                        "Long": -79.3401336669922
                    },
                    "Assigned": false
                },
                {
                    "NCESDistrictID": null,
                    "AmenityID": "461830-CA",
                    "Name": "Queen Alexandra Middle School",
                    "Address": "181 Broadview Ave",
                    "Category": "elem",
                    "Dist": 467,
                    "Tag": "Elementary",
                    "District": null,
                    "LowGrade": "6",
                    "HighGrade": "8",
                    "SchoolScore": "61.5",
                    "Site": "http:\/\/schoolweb.tdsb.on.ca\/queenalexandra",
                    "City": "Toronto",
                    "StateAbbr": "ON",
                    "ZIP": "M4M 2G3",
                    "Phone": "416-393-9535",
                    "IsPre": "0",
                    "IsElem": "1",
                    "IsMid": "1",
                    "IsHigh": "0",
                    "ProfMath": "43",
                    "ProfLang": "80",
                    "WalkingTime": 7,
                    "Coord": {
                        "Lat": 43.6614952087402,
                        "Long": -79.3501281738281
                    },
                    "Assigned": false
                },
                {
                    "NCESDistrictID": null,
                    "AmenityID": "067547-CA",
                    "Name": "Bruce Public School",
                    "Address": "51 Larchmount Ave",
                    "Category": "elem",
                    "Dist": 975,
                    "Tag": "Elementary",
                    "District": null,
                    "LowGrade": "JK",
                    "HighGrade": "8",
                    "SchoolScore": "62.125",
                    "Site": "http:\/\/schoolweb.tdsb.on.ca\/bruce",
                    "City": "Toronto",
                    "StateAbbr": "ON",
                    "ZIP": "M4M 2Y6",
                    "Phone": "416-393-0670",
                    "IsPre": "0",
                    "IsElem": "1",
                    "IsMid": "1",
                    "IsHigh": "0",
                    "ProfMath": "49",
                    "ProfLang": "75.25",
                    "WalkingTime": 16,
                    "Coord": {
                        "Lat": 43.6610527038574,
                        "Long": -79.3333511352539
                    },
                    "Assigned": false
                }
            ]
        }
    },
    "Active": 1

Example Calls

node.js

const baseUrl = 'https://api.proximitii.com/v1/demographics/';

const keyPublic = 'YOUR PUBLIC KEY';
const keyPrivate = 'YOUR PRIVATE KEY';

const headers = new Headers({
  'Public-Key': keyPublic,
  'Private-Key': keyPrivate
});

const params = new URLSearchParams({
  lat: '42.3444676',
  lon: '-71.0691738',
  radius: '1',
  munit: 'mi',
  categories: 'all'
});

async function getDemographics() {
  try {
    const requestUrl = `${baseUrl}?${params.toString()}`;
    const response = await fetch(requestUrl, {
      method: 'GET',
      headers: headers
    });
    
    const data = await response.json();
    console.log(data);
    return data;
  } catch (error) {
    console.error('Error fetching data:', error);
  }
}

getDemographics();

PHP

<?PHP	
	$url = "https://api.proximitii.com/v1/demographics/";

	$key_public = 'YOUR PUBLIC KEY';
	$key_private = 'YOUR PRIVATE KEY';

	$headers = [
		"Public-Key: {$key_public}",
		"Private-Key: {$key_private}"
	];			

	$params = array(
		'lat' => '42.3444676',
		'lon' => '-71.0691738',
		'radius' =>  '1',
		'munit' => 'mi',
		'categories'=>'all'
	);

	$ch = curl_init ($url . '?' . http_build_query($params));
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	$data = curl_exec($ch);
	$data = json_decode ($data, true);	
?>

Keys

In order to call the API successfully, you will need a public and private key. Make sure to store the keys safely and call the API on the backend so the keys are not exposed to the public.

Values

Categories:

Sample Output

{
    "data": {
        "population": {
            "Population": "1560",
            "Density": 13569,
            "PctWhite": 61.7,
            "PctBlack": 8.38,
            "PctNative": 0.28,
            "PctAsian": 16.95,
            "PctHawaiian": 0.22,
            "PctOtherRaceAlone": 4.44,
            "PctMultiRacial": 8.03,
            "HispanicOrLatino": null,
            "MedianAge": 38.05,
            "PctMarried": 34.81,
            "PctWithKids": 10.14,
            "PctPoverty": 20.85,
            "PctOtherLang": 33.09
        },
        "age": {
            "PctUnder5": 3.5,
            "PctBetween5_14": 4.99,
            "PctBetween15_19": 5.11,
            "PctBetween20_24": 10.55,
            "PctBetween25_34": 24.13,
            "PctBetween35_44": 12.3,
            "PctBetween45_54": 11.47,
            "PctBetween55_64": 11.52,
            "PctBetween65_84": 14.34,
            "PctOver85Plus": 2.08
        },
        "languages": {
            "PctSpeakEnglish": 66.91,
            "PctSpeakSpanish": 9.98,
            "PctSpeakEuropean": 7.69,
            "PctSpeakAsianPacific": 12.81,
            "PctSpeakOther": 2.61
        },
        "economy": {
            "IncomePerCapita": "106139.90",
            "MedHouseholdIncome": "119509.02",
            "PctUnemployed": 3.55,
            "PctInc10K_Less": 10.83,
            "PctInc10K_25K": 13.95,
            "PctInc25K_40K": 5.31,
            "PctInc40K_60K": 8.72,
            "PctInc60K_100K": 11.77,
            "PctInc100K_150K": 12.02,
            "PctInc150K_200K": 8.77,
            "PctInc200K_More": 28.63
        },
        "education": {
            "PctCompleted8thGrade": 94.61,
            "PctCompletedHighSchool": 90.54,
            "PctSomeCollege": 80.81,
            "PctAssDegree": 73.06,
            "PctBachelorsDegree": 69.81,
            "PctMastersDegree": 37.39,
            "PctProSchoolDegree": 16.44,
            "PctDoctorateDegree": 6.35
        },
        "housing": {
            "HousingUnits": "822",
            "Households": "761",
            "MedValueOwnerOccupied": "1330327",
            "MedRent": "2330",
            "AvgHouseholdSize": 1.76,
            "PctOwnerOccupied": 31.36,
            "PctRenterOccupied": 68.64,
            "PctPrice50k": 4.02,
            "PctPrice100k": 0.42,
            "PctPrice150k": 0,
            "PctPrice200k": 0.83,
            "PctPrice300k": 2.45,
            "PctPrice500k": 5.99,
            "PctPrice1m": 27.45,
            "PctPrice2m": 32.74,
            "PctPrice2mPlus": 26.1,
            "PctMovedIn2021Plus": 5.51,
            "PctMovedIn2018": 18.6,
            "PctMovedIn2010": 35.58,
            "PctMovedIn2000": 22.42,
            "PctMovedIn1990": 10.68,
            "PctMovedIn1989Earlier": 7.19,
            "PctSingleFamily": 1.38,
            "PctSemiDetached": 7.4,
            "PctTownhouse": 15.71,
            "PctSmallApt": 29.36,
            "PctLargeApt": 46.06
        },
        "commute": {
            "AvgCommuteTime": null,
            "PctDrive": 19.37,
            "PctCarpool": 2.84,
            "PctPublicTrans": 21.02,
            "PctMotorcycle": 0.03,
            "PctBicycle": 2.28,
            "PctWalk": 34.33,
            "PctWorkHome": 18.59
        },
        "workforce": {
            "PctInAgriOrForestOrFishOrHuntOrMining": 0.05,
            "PctInConstruction": 1.46,
            "PctInManufacturing": 5.05,
            "PctInWholesaleOrRetail": 7.35,
            "PctInTransportationOrWharehousingOrUtilities": 1.77,
            "PctInInformation": 2.38,
            "PctInFinanceOrInsurance": 13.01,
            "PctInRealEstateOrRentals": 2.23,
            "PctInProOrSciOrTechServices": 21.01,
            "PctInManagement": 0.18,
            "PctInAdminAndWasteMgmt": 2.76,
            "PctInEduOrHealthOrSocialServices": 28.99,
            "PctInArtsOrEntOrRecOrFoodServices": 8.37,
            "PctInOtherServices": 3.47,
            "PctInPublicAdmin": 1.92
        }
    },
    "error": {
        "code": "201",
        "message": "Created"
    }
}

Installation

Add the following embed code to your page or template. In order for the widget to render, you must add your own public key and you must pass the latitude and longitude.

<script src="https://widget-api.proximitii.com/crime/embed.js"></script>
<div id="prox-crime-map"></div>
<script type="module">
window.onProximitiiCrimeLoad = () => {
let proximitiiCrimeMap = new ProximitiiCrimeMap('prox-crime-map')

//Make sure to put in your own public key!
proximitiiCrimeMap.setPublicKey("YOUR OWN KEY HERE")

proximitiiCrimeMap.setCenter(37.772079370456495, -122.42953237968246)

proximitiiCrimeMap.setOptions({
    centerMarker: false,
    height: '500px',
    zoom: 10
})
        
proximitiiCrimeMap.render()
}
</script>

Values

Installation

Add the following to the head of your page.

<!-- Proximitii script	-->
<script src="https://proximitiimaps.com/proxinit/"></script>	
		
<!-- Your script -->
<script src="prox-map.js"></script>

Add the following to the body of your page.

<div id="my-map" class="leaflet-pane:leaflet-map-pane"></div>

Add the following .js file to your server.

window.onload = () => {
	
	const gps = [43.654087, -79.38549];		//center of the map
	const opts = {					//map options	
		id:     'my-map',			//DIV id
		key:    'my-key-here',		        //your private key
		gps:    gps,
		zoom:   14,				//zoom level
		style:  'init_style_light',		//map style
		func:   onMapReady			//callback
	};
	
	var map_init = new ProxMap (opts);		//create the map
	map_init.create_map ();

	function onMapReady ()
	{
		var map = map_init.get_map ();	        //get map object
		if (map)
		{
			L.marker(gps)			//create marker	
				.bindPopup("Hello <b>Map</b>")
				.addTo(map)
				.openPopup();

			var popup = L.popup();		//popup onMapClick event func
			function onMapClick(e) {		
				popup
				.setLatLng(e.latlng)
				.setContent("Click at " + e.latlng.toString())
				.openOn(map);
			}
			map.on('click', onMapClick);	//click event
		}
	}
}

Here is a sample .html file.

<!DOCTYPE html>
<html lang="en">
	<head>
		<title>Proximitii Maps</title>
		<meta name="viewport" content="width=device-width, initial-scale=1.0">
		<meta charset="utf-8">

		<style>
			html, body {
				width: 100%;
				height: 100%;
				padding: 0;
				margin:0;
			}	
			#my-map { position: relative; width: 100%; height: 100%;}
		</style>
	  
		<script src="https://proximitiimaps.com/proxinit/"></script>	
		<script src="prox-map.js"></script>
	</head>

	<body>	
		<div id="my-map" class="leaflet-pane:leaflet-map-pane"></div>
	</body>
</html>

Values

General Options:

Map Styles

Light

Bright

Modern

Baseline