{"info":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","description":"

Telus Insights solution helps customers utilize TELUS Geo-intelligence data assets and help answer a range of questions around location and movement patterns within Canada.

Key Highlights of TELUS Insights Location API:

Process and record over 3B location data records per day.
Data assets are enhanced using algorithmic logic, and data models providing meaningful location based insights
We have developed an advanced set of privacy and security de-identification techniques leveraging the Privacy and Security by Design Standards meaning that the data in use is completely stripped of personal information, and securely managed.
RESTful API’s and advanced API Gateway management means that data ingestion, integration and consumption is easy, up to date, and meets the necessary data management standards.
A Developer Portal that is much more than just API documentation. It is serving mulitple purposes including enabling users to explore interactively the API endpoints through a user-friendly interface. See API vs Developer Portal for more details.

Introduction - Generalities

Data Recency

Data is collected and processed every 5 mins from our network, and through a series of data processing jobs
Live data is processed, transformed, and made available within our Data Warehouse within 1-2 hours
Results are provided at a minimum of 15 minute intervals to ensure privacy.

Data Retention

Data available from January 1, 2019
Data will remain in the system for up to 5 years, starting from this date.

Coverage / Users

9.8M Canadians, and 3M+ International devices (monthly average)
TELUS has network coverage in 99% of the populated areas of Canada. This means that if you are looking for information on areas where people are located, we will likely have it.

Data Storage

All data is stored in Canada within secure data facilities with the ability to scale to accomodate for both the massive amounts of data, and the demands of users querying the system.

Data Privacy

Removal of key identifiers from the dataset, replacing them with pseudonymous persistent identifiers. More on Data Privacy here.
All data released by the platform is aggregated so that any output is at a minimum of 20 devices post-extrapolation, and rounding. This aggregation is done across spatial and temporal dimensions.
All data is rounded-up to the nearest 10 counts.
All results are extrapolated to represent the entire population to provide a layer of privacy.
TELUS uses internal market intelligence and external sources to determine factors down to a census sub-division level for Canadians, and to country level for international markets.
TELUS has updated its privacy policy to ensure that there is enough information available to the general population on what we are doing.
We have sought outside expertise from a range of trusted Privacy advisors and Privacy tech companies to validate our approach
Achieved Privacy By Design certification
Close collaboration and partnership with TELUS Data & Trust Office, ensuring inclusion in any key product decisions.

Limitations

The API results depend on cell tower locations at the time of the analysis. As Telus is continuously optimizing its network coverage, some of the cell towers might change locations over time which might result in a slight impact on the API outputs.
Due to technical issues, the API will not return any results for the dates listed above as the data was not captured in our system:
- June 14, 2021
- June 15, 2021
- June 16, 2021
\n

Introduction - Spatial aggregation

TELUS Insights API data is based on the locations of Cellular towers, and their coverage areas. This means that results spatial granularity is dependent on the cellular coverage in the area. In urban areas, coverage accuracy is sub-200 meter, in suburban areas it ranges between 200m and 1km, in rural areas the coverage areas are between 1 and many kilometers, depending on the remoteness of the location.
In general, networks are modelled after human population and mobility behaviours. For example, towers will be aligned to all major roadways, with a tower at or between each exit. This means that we can build detailed results around travel patterns on major roads, even if the coverage in remote areas is in the several kilometer range.
Spatial accuracy can further be improved by using data sources that align tower locations to where devices commonly connect to the given tower. These data sets help us further align towers to roadways, improving accuracy in distinguishing between parallel road segments.
In some areas of Canada, the deployment of small cell technology (the precursors to 5G) allow for intersection level accuracy within neighbourhoods. This technology requires for small cell sites to be deployed on existing infrastructure, such as light standards, traffic signals, or phone line poles. This significantly increases the resolution spatially of the data, into the 5-10m range.
TELUS Insights data has the ability to aggregate results to customer specified areas, or road segments, because the data is collected based on tower location. Overall this means that the work of correlating tower locations to customer specified areas is complete by TELUS Insights.

Introduction - Methodologies

Assumed Primary and Secondary neighbourhoods methodology

TELUS Insights has developed a proprietary algorithm to determine the primary and secondary neighbourhood of the devices. This algorithm looks at a series of factors, such as time spent in an area, number of days spent, frequency of visits, consecutive hours, and others, to decide the primary and secondary neighbourhoods of a device. This algorithm is designed to ensure the model works in a broad range of conditions, including rural, and urban areas.

The algorithm has been built in a way that the secondary neighbourhood is not confused with primary neighbourhood.

Extrapolation methodology

To be fully representative of the Canadian population, TELUS Insights extrapolates the subscriber data based on our market share information. TELUS builds highly detailed market shares, broken down by census sub-divisions. These market shares account for many variables, including the likelihood of an individual owning multiple devices, the drop off points of access to cellular service, as well as area populations. Each device is given a multiplier to help it be representative of its home neighbourhood at a census sub-division level.

Introduction - Insights Developer Portal

Insights Developer Portal enables the users to explore, interact and query the API through an intuitive interface.

Devoloper Portal provides self-serve capabilities on top of the API such as:

API Documentation
API credentials
Support desk
Product notifications
More to come

Insights Developer Portal Homepage

\n\n

Introduction - API Integrations

In order to build automated solutions for API consumption, we recommend the following process and best practices

1. OAuth Credentials

Request OAuth credentials by creating a ticket in the Portal. Check your My Account page in the portal to determine if you already have them.

2. Creating Script Snippets

To create scripts for your favorite language you can get some code snippets from the “Example Request” section for each API on this site.

\n\n

# Set your credentials - Check My Account Page\ncustomerId=\"\"\noauth_client_id=\"\"\noauth_client_secret=\"\"\n# OAuth config - Check My Account Page\noauth_token_endpoint=\"\"\noauth_grant_type=\"\"\noauth_scope=\"\"\nlocation_api_url=\"\"\n# Set thresholds\nwaitSecondsBeforeFetchingJobResults=300s\n# Set your request body variables. You can use the JSON preview feature in the Portal to get this info.\ninputRequestId=\"your-input-request-id\"\ninputStudyZones='\"studyzone-1\",\"studyzone-2\"'\noutputRequestId=\"your-input-output-id\"\noutputStudyZones='\"studyzone-1\",\"studyzone-2\"'\nstartTime=\"2020-10-04T00:00:00\"\nendTime=\"2020-10-06T00:00:00\"\n# See Swagger file for info on api request body\napi_path=\"home\"\napi_request_body='{\"input_geoid\": {\"requestId\": \"'${inputRequestId}'\",\"study_zone\": ['${inputStudyZones}']},\"output_geoid\": {\"requestId\": \"'${outputRequestId}'\",\"study_zone\": ['${outputStudyZones}']},\"start_time\": \"'$startTime'\",\"end_time\": \"'$endTime'\",\"time_bucket_size\": 15,\"exclusion_types\": []}'\n# Get access_token \naccess_token_expiry_time=`date`\ncurrent_date_time=`date`\necho \"Getting access token - current_date_time=$current_date_time\"\naccess_token_data=$(curl --request POST \\\n    --url \"${oauth_token_endpoint}\" \\\n    --header \"content-type: application/x-www-form-urlencoded\" \\\n    --data grant_type=${oauth_grant_type} \\\n    --data client_id=\"${oauth_client_id}\" \\\n    --data client_secret=\"${oauth_client_secret}\" \\\n    --data scope=\"${oauth_scope}\")\naccess_token=$(echo $access_token_data | jq --raw-output .access_token)\naccess_token_expiry_in_seconds=$(echo $access_token_data | jq --raw-output .expires_in)\naccess_token_expiry_time=$(date --date=\"+$(expr $access_token_expiry_in_seconds - 5) seconds\")\necho \"Authorization: Bearer ${access_token}\"\n# POST a Job\njobStartTime=`date \"+%Y-%m-%d %H:%M:%S\"`\njobData=$(curl --request POST \\\n    --url \"${location_api_url}/count/${api_path}\" \\\n    --header \"content-type: application/json\" \\\n    --header \"Authorization: Bearer ${access_token}\" \\\n    --header \"customerid: ${customerId}\" \\\n    --data \"${api_request_body}\")\n# Retrive the Job Id\necho \"jobData=${jobData}\"\njobId=$(echo $jobData | jq --raw-output .jobId)\necho \"jobId=$jobId\"\n# Check Job Results in a loop\necho \"Starting the GET loop for a job.........\"\nstatus=\"not-done\"\nwhile [ $status != \"COMPLETE\" ]\ndo\n    echo \"sleeping for $waitSecondsBeforeFetchingJobResults .... \"\n    sleep $waitSecondsBeforeFetchingJobResults\n    echo \"checking job status .... \"\n        # Refresh access_token if its  expiry time is in the past\n    current_date_time=`date`\n    if [[ $(date +%s -d\"$access_token_expiry_time\") -le $(date +%s -d\"$current_date_time\") ]]\n    then \n        echo \"Getting access token - access_token_expiry_time=$access_token_expiry_time, current_date_time=$current_date_time\"\n        access_token_data=$(curl --request POST \\\n            --url \"${oauth_token_endpoint}\" \\\n            --header \"content-type: application/x-www-form-urlencoded\" \\\n            --data grant_type=${oauth_grant_type} \\\n            --data client_id=\"${oauth_client_id}\" \\\n            --data client_secret=\"${oauth_client_secret}\" \\\n            --data scope=\"${oauth_scope}\")\n        access_token=$(echo $access_token_data | jq --raw-output .access_token)\n        access_token_expiry_in_seconds=$(echo $access_token_data | jq --raw-output .expires_in)\n        access_token_expiry_time=$(date --date=\"+$(expr $access_token_expiry_in_seconds - 5) seconds\")\n        # echo \"Authorization: Bearer ${access_token}\"\n    fi\n        results=$(curl --request GET \\\n    --url \"${location_api_url}/count/${api_path}/${jobId}\" \\\n    --header \"Authorization: Bearer ${access_token}\" \\\n    --header \"customerid: ${customerId}\")\n        # Check job status\n    # echo \"results=${results}\"\n    status=$(echo $results | jq --raw-output .status)\n    if [[ $status != \"COMPLETE\" ]]\n    then \n        echo \"Not complete yet, will poll again ...\"\n    else\n        jobEndTime=`date \"+%Y-%m-%d %H:%M:%S\"`\n        echo \"Results received ...............\"\n        echo \"status=$status. Job results saved to ${jobId}.json\"\n        echo \"Total time taken=$(expr $(date -d \"$jobEndTime\" \"+%s\") - $(date -d \"$jobStartTime\" \"+%s\")) seconds\"\n        echo \"$results\" >> ${api_path}.${jobId}.json\n    fi\ndone\n\n

Introduction - API Restrictions and Usage

API Restrictions

Currently Rate-limiting is not implemented for the API. However, in order to ensure the API performance and stability, it is strongly recommended that all users follow the below limitations:

1 Day Queries

Minimum Time Bucket Size of 15 min is allowed for queries ranging up to 1 day period

30 Day Queries

Minimum Time Bucket Size of 60 min is allowed only for queries ranging up to 30 days period

More than 30 Day Queries

Minimum Time Bucket Size of 24 Hrs is allowed for queries more than 30 days

Concurrent Queries

Only run 5 concurrent queries at a time. This includes queries submitted via the API and the portal.

Query Volume

Only run 10 queries per hour and 100 queries per day

Usage Statistics

We have now made available the usage statistics at an organization level to help you understand the overall API consumption. This feature primarily provides the following:

Number of monthly API Calls
Number of Study Zones queried

This will enable you to understand and administer your organization's usage against the plan's limit.

'Usage Statistics' option has been made available under 'Account Settings' as depicted below:

\n\n

By default, the statistics will be displayed for the current month and year which could be changed using the dropdowns.

There are three parts to Usage Statistics.

Part 1: Primary information i.e. number of monthly API Calls and number of Study Zones queried for the selected month and year as depicted below:

\n\n

Part 2: End-point wise breakdown of the total API Calls based on the selected month and year as depicted below:

\n\n

Part 3: Comparison of total no. of API Calls and Study Zones queried in the current year (based on selection) and the previous year as depicted below:

\n\n

Best Practices

Query Processing Time

The processing time is proportional to the complexity of the query and the volume of the data being fetched. In order to reduce the processing time, it is highly recommended to break down your queries for smaller date ranges.

OAuth Token

When getting an OAuth Token from the Token URL, it is preferable that you reuse the token for specified amount of expiry seconds (present inside the token JSON and set to 299 seconds). That prevents the identity system from being overwhelmed.

Wait Time before results

The API is asynchronous, when a POST is submitted to start a job, a Job Id is returned. The job results can be fetched by doing a GET using the Job Id. It is recommended to wait a minimum of 5 minutes before submitting a GET for the results. Because the job results are not guaranteed within 5 minutes, we recommend that you create a loop to check the results based on the “status” field equal to “COMPLETE” that you get back in the API response.

Volume of Queries

To protect our platform from overload, we recommend users not to exceed 10 queries on average per hour and 100 queries per day. Please note that these are averages for full POST and GET cycle of the request. This means that it is OK for you to submit (POST) 10 queries within a minute and then wait for them to complete (GET) within an hour.

Getting Started

We are invested in your success and wrote this guide to help you get started in the quickest and most optimal manner. This quick Start Guide will help you analyze your first study zone and unlock your first insights. Specifically, it will cover:

Authentication
Upload Shapefile
Run a job
Data Dictionary and Formats
Exclusion Types
API Function Descriptions

Getting Started - Authentication

Telus Insights Portal

Authentication to Telus Insights Portal (https://insights.telus.com) will be done through Telus Client Identity. Two emails will be sent as a part of the onboarding process – first will be an informative email (from dlTelusInsights@telus.com) containing links to the Telus Insights Portal and our API Documentation and the other will be an activation/registration email through our Telus Client Identity system (do.not.reply@telus.com) that would allow you to create a password. The user ID is the email address.

Note: If you are already registered with Telus Client Identity, you could start accessing Telus Insights Portal once you receive the informative email from dlTelusInsights@telus.com.

API

To authenticate to the API - https://location-api.insights.telus.com, please refer to OAuth credentials (Client Id and Secret) and the configuration details on your 'My Account' page in Telus Insights Portal. More details could be found on the API Integrations page.

Getting Started - Shapefiles and Study Zones

A study zone is a location, or set of locations defined as a geospatial boundary otherwise known as a “Geo Fence” that defines an area such as a Mall, an FSA, FSA-LDU or Census boundary.

Before making a POST/GET request to the Count endpoint, areas of study needs to be defined. The areas of study are a list of “Study Zones” (aka polygons) defined within the shapefile. Each Study Zone will have a series of latitude and longitudes associated with the Study Zone.

Each study area will be defined, uploaded and maintained in the system as a set of Latitude Longitude that encapsulate a geo fence.

Before a user can query the Count endpoint, a study zone must be defined which includes a location, or group of locations you would like to include in analysis.

You could either create your own Custom Shapefile using our shapefile endpoint or use one of the Public Shapefiles downloaded from Stats Canada website made available to you for your analysis.

Public Shapefiles

Public shapefiles are geo-spatial files that store standard areas defined by public Canadian authorities such as Census Subdivision (CSD) and Forward Sortation Areas (FSA).

Source of the files: Stats Canada website

Type of files: Digital Boundary Files

Naming convention for shapefiles and study zones:
Original shapefiles have been broken down into Provincial files. For uniformity, shapefile and study zone name length will follow the same length requirements for custom shapefiles/study zones i.e. shapefile name will be <= 75 characters and study zone name length will be <= 50 characters.
Following is the file and shapefile naming conventions:

CSD files:

public_canada_csd_CensusYear_PRCode_PRUID.zip\n\n

Census Year is the year for which file is available, PR Code is the province/territory code and PRUID is the unique identifier for each province/territory.

Example shapefile name: public_canada_csd_2021_bc_59.zip\nExample RequestID: public-canada-csd-2021-bc-59-zip-{random GUID}\n\n

For study zones, naming convention is 'CSD Name' followed by 'CSD Type'. There are about 50 CSDs which have duplicate CSD Name and Type combination; to uniquely identify these CSDs in the system, 'DGUID' has been appended into the study zone name.

Example without DGUID: Victoria(CY)\nExample with DGUID: Okanagan (Part) 1(IRI)(5937801)\n\n

References: Dictionary, Census of Population, 2021

FSA files:

public_canada_fsa_CensusYear_PRCode_PRUID.zip\n\n

Census Year is the year for which file is available, PR Code is the province/territory code and PRUID is the unique identifier for each province/territory.

Example shapefile name: public_canada_fsa_2021_bc_59.zip\nExample RequestID: public-canada-fsa-2021-bc-59-zip-{random GUID}\n\n

For study zones, CFSAUID which uniquely identifies a forward sortation area composed of three alphanumeric characters.

Example: V3T\n\n

References: Forward Sortation Area, Boundary File, Reference Guide

Release dates:

CSD Files: 2021

FSA Files: 2021

How to use Public Shapefiles:
Public Shapefiles are made available on the Job Tool screen below the Custom Shapefiles under Shapefile/RequestID drop-down list as depicted below.

\n\n

Geofence endpoint will also return the list of Public Shapfile Request IDs below the Custom Shapefile Request IDs list.

Future Changes: A separate section under 'Study Zone Management' in the Portal to view details of Public Shapefiles.

Uploading a shapefile / preparing your Study Zones

This section explains the process of uploading custom shapefiles.

The system supports multiple formats including Google’s KML (Keyhole Markup Language), ESRI Shapefiles and GeoJson.

Our shapefile endpoint allows you to do the following:

Upload your own unique shapefiles and polygons (study zones/areas)
Polygons could be anything including but not limited to:
- Province
- City
- Region
- Postal codes
\n
Shapefile information including study zone names are stored for future use
This information is stored in our application database for fast processing

Once the shapefile has been accepted by the system, it will return a requestID. This requestID, once processed, along with the Study Zone names will be what you use to make the calls to the Count endpoints.

Shapefile format requirements

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Requirements	Details
Format	.kml (Google Keyhole Markup) .zip (ESRI Shapefile) .json
Formats in ZIP file	.dbf, .prj, .shp, .shx, .cpg
Max File Size	25 MB
Max Row Size for Study Zone	4 MB
Column Names	Add 'study_zone' column and list out all relevant polygon coordinates
Max no. of Study Zones	2000
File name length	75 characters
Study Zone name length	50 characters
Study Zone name	1. Must be unique 2. Must NOT contain backslashes or quotation marks 3. Cannot be changed after upload
Polygon Coordinates	Our system only handles flat geometries i.e. the coordinates must be two dimensional Sample coordinates: -100.0000000, 50.0000000 If the shapefile contains a third dimension (Z), the same will be ignored and only the X and Y coordinates will be stored for processing. Sample coordinates with third dimension: -100.0000000, 50.0000000, 2 Coordinates stored for processing: -100.0000000, 50.0000000

\n\n

Getting Started - Run a job

We can run a job through below two options:

Insights Developer Portal
Rest API

Insights Developer Portal

Insights Developer Portal have the ability to test, explore all the API endpoints through Insights Developer Portal, by selecting a job type in Data Job tool.

\n\n

You can also edit an existing job and re-run it from View Data Jobs screen.

Rest API

Asynchronous Computation

When a request is submitted, the client application makes a synchronous call to the API, triggering a long-running operation on the backend on the order of seconds or minutes.
API responds synchronously as quickly as possible. It returns an HTTP 202 (Accepted) status code, acknowledging that the request has been received for processing.
API validates both the request and the action to be performed before starting the long running process. If the request is invalid, API will reply immediately with an error code such as HTTP 400 (Bad Request).
While the request is still pending, the status endpoint returns HTTP 202 status code and request status as \"Processing\". Once the request is complete, the status endpoint will return required results which indicates completion of request.

\n\n

Job Queues

We use a two part POST and GET method when making a call to our Endpoints. The POST request will validate the request and return a job ID, which should then be used to obtain the results via the GET request.

Queries are processed based on available computation space.

Most of the time, your results will be available on your first GET call. If it is not, it could be because your request is very large, or the server is busy. In this case, you may need to check the status of your request more than once. As a best practice, retry GET every 5 minutes.

The schema below shows a typical workflow for a study using the Location API. First, you will post your postRequest. Then you will post your getRequest to retrieve the status of your task.

HTTPS POST request

The data processing from the API calls are computed asynchronously. This means that you won't get the results of your call immediately. You will be returned a JobID, which represents the request you have made for the system.

{\n  \"jobId\": \"84f4a1ba-a0d7-41d8-bc09-944440da6476\",\n  \"link\": {\n    \"rel\": \"dwelltime\",\n    \"url\": \"/count/dwelltime/84f4a1ba-a0d7-41d8-bc09-944440da6476\"\n  }\n}\n\n

There are multiple ways to POST a request to a REST API.

Best Practices:

Use an extension for your browser such as:
- Chrome: Postman, Advanced REST Client
- Firefox: REST Easy, RESTClient
\n
As a POST method, parameters of the request are not directly included in the URL. You need to attach them to your request.
The parameters/arguments are always in JSON format, with the returned response always in JSON.
The specific parameters depend on the API function you want to call.
- The JSON response can be converted easily to CSV / excel using a variety of tools from the internet.
\n

To find more information on what arguments to pass, please refer to the API's Reference section

HTTPS GET request

To get the status of your POST request, you need to send a request to the corresponding getRequest method using JobID generated during POST request for the respective API endpoint.

After GET request is submitted, if the computation is completed, this method will return the results similar to below results.

{\n  \"requestId\": \"51a11295-2a94-40ac-82e5-29161faf9000\",\n  \"study_zones\": [\n    {\n      \"geoid\": \"Kelowna\",\n      \"buckets\": [\n        {\n          \"bucket\": \"2019-01-01T00:00:00\",\n          \"0-15\": 35900\n        }\n      ]\n    }\n  ],\n  \"bucket_size\": 1440,\n  \"start_time\": \"2019-01-01T00:00:00\",\n  \"end_time\": \"2019-01-02T00:00:00\"\n}\n\n

Otherwise it will return a status of PROCESSING until request is completed.

{\n  \"jobId\": \"84f4a1ba-a0d7-41d8-bc09-944440da6476\",\n  \"status\": \"Processing\",\n  \"link\": {\n    \"rel\": \"dwelltime\",\n    \"url\": \"/count/dwelltime/84f4a1ba-a0d7-41d8-bc09-944440da6476\"\n  }\n}\n\n

Getting Started - Data Dictionary and Formats

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Data Attribute	Data Type	Format	Min / Max Values	Description
`dwell_time_bucket`	Integer	0	Min = 0 Max = no max	Specifically for the Dwell time API. This is to group count based on dwell time for each study zone. This is value in minutes. For e.g. when dwell_time_bucket is set to 60, output will contain dwell time bukcets as 0-60, 61-120, 121-180
`time_bucket_size`	Integer	0	Min = 0, Max=no max	Bucket size defines the number of minutes the result will be broken down into. For example 30 would mean the bucket time increment size is 30 minute aggregates or 1440 would mean the data is aggregated by day. Bucket size does not have a minimum or max limit, except for Demographic endpoint which has 1440 as a minimum value. By not selecting bucket size, it will return a collective number for the entire time period specified within the start to end date period.
`timeframe_bucket`	Integer	0	Min = 0, Max=no max	Timeframe bucket defines the timeframe ie date of each bucket. For example 2020-10-04T13:15:00:00.
timezone	String	UTC		Timezone for request. Valid values are UTC, AST, CST, EST, PST, MST and NST. Default is UTC
`start_time`	String	2020-01-03T00:00:00	Min=2019-01-01T00:00:00, Max=present day	Start time for request. We use the ISO8601 format for all our start and end times.
`end_time`	String	2020-01-03T01:00:00	Min=2019-01-01T00:00:00, Max=present day	End time for request
`job_id`	Alpha-numeric	84f4a1ba-a0d7-41d8-bc09-944440da6476		Unique identifier generated when a POST request is made via the query end points
`customer_id`	Alpha-numeric	84f5f015-658e-4f9b-829e-a8b9c89324b4		This is the unique ID generated when \"Create Customer ID\" is performed which creates the association of a customer with their unique API key.
`request_id`	Alpha-numeric	51a11295-2a94-40ac-82e5-29161faf9000		This is the unique ID generated for each shapefile that has been uploaded
`study_zone`	String	Toronto		This is the name/label of the study area (polygon) defined based on the shapefile upload. For example, your study zone could be a city, province, or even a POI like \"Roger's Centre\"
`exclusion_type`	Array	Worker		This is further segmenting the type of individuals who are within that particular area. We have the following types: Resident, Non-Resident, Worker, Non-Worker. You cannot select Resident / Non-resident together, or Worker / Non-Worker together.
`min_dwell_time`	Integer	0	Min = 15, Max=no max	This is the minimum time threshold (in minutes) for a user to have dwelled within the location. The time window between Min and Max Dwell must be a greater than 15 minutes
`max_dwell_time`	Integer	0	Min = 15, Max=no max	This is the max time threshold (in minutes) for a user to have dwelled within the location. The time window between Min and Max Dwell must be greater than 15 minutes.

`input_geoid`	Alpha-numeric	2c7f6019-91a0-41e3-8e57-3250447bd902.Downtown		This is to specify the query we are doing on a particular location. This is made up of a request ID, and one or more study zones.
`output_geoid`	String	Kelowna		Output is used when we want to break down the input of a particular study zone, which has been specified as a part of input_geoid. For example Input could be Toronto, and the outputs could be broken down by suburb, ie Annex, Liberty Village, Ossington etc.
`geoid`	String	Vancouver		This is the names of each of the study zones (polygons) that have been uploaded via the shapefiles. This could be province names, city names, regions, postcodes (these are all mapped to a series of latitudes/longitudes). Geo-ID is the same as Study Zone, however it is the name used on the GET return as opposed with Study Zone which is used on the POST request.
`topic`	String	Hindi		The topics are a list of demographics that can be selected as part of the input parameters within the Demographic endpoint.
`primary_threshold`	Decimal	0.5	Min = 0, Max = 1	is a value between 0 and 1 and set the bounds at which the equation will separate out the primary, secondary and tertiary zones.
`secondary_threshold`	Decimal	0.5	Min = 0, Max = 1	is a value between 0 and 1 and set the bounds at which the equation will separate out the secondary and tertiary zones.
`count_weight`	Decimal	0.4	Min = 0, Max = 1	A value between 0 and 1 that represents how important the unique count from the given output should be in selecting if the area is a primary, secondary or tertiary area.
`trip_weight`	Decimal	0.4	Min = 0, Max = 1	A value between 0 and 1 that represents how important the total trips from the given output should be in selecting if the area is a primary, secondary or tertiary area.
`distance_weight`	Decimal	0.4	Min = 0, Max = 1	A value between 0 and 1 that represents how important the distance from the given output should be in selecting if the area is a primary, secondary or tertiary area.
`cross_zone_analysis`	Boolean	true/false		'Cross-zone Analysis' will return the count of devices that visited all of the selected study zones. It is suggested to not break down results using time bucket size while conducting cross-zone analysis. Default value is `false`
`pass_through_geoid`	Object	`\"pass_through_geoid\": { \"requestId\": \"4693-89d5-1683d2774704\", \"study_zone\": [\"Seven Oaks\"] },`		Specifically for Origin and Destination end-points. With pass-through study zone(s) selected, these end-points will return the counts of devices which travelled from Origin to Destination via the study zone(s) selected under pass-through geo-id.

Getting Started - Exclusion Types

Exclusion types are ways to segment the query down further to exclude / include certain types of devices based on segmentation such as demographic, identity, or other defined categories.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Exclusion	Description
residents	A device who's assumed Primary neighbourhood falls under the defined study zone.
non-residents	A device who's assumed Primary neighbourhood falls outside of the defined study zone.
workers	A device who's assumed Secondary neighbourhood falls under the defined study zone.
non-workers	A device who's assumed Secondary neighbourhood falls outside of the defined study zone.

API Descriptions

Shapefile (Study Zone Management)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Endpoint	Description
Create New Area (upload a shapefile)	Please refer to 'Uploading a shapefile / preparing your Study Zones' section under 'Getting Started - Shapefiles and Study Zones'
Status (retreive status of the shapefile)	Check the status of the shapefile, to ensure it has been processed sucessfully
Geofence report	See a list of uploaded shapefiles. This report will also include the list of public shapefiles appended below the list of custom shapefiles uploaded by that user.

Count

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Description	Example
Unique	Returns the number of unique devices available in the input study zone based on the input parameters.	How many unique devices visited Vancouver on May 1, 2022 between 9 AM and 1 PM.
Origin	Returns the count of devices with trips origination from each output study zone (origin) and terminating to each input study zone (destination) as specified by the input parameters.	How many devices traveled from Vancouver (Origin) to Burnaby (Destination) on 1st May, 2022 between 9 AM and 1 PM.
Destination	Returns the count of devices with trips origination from each input study zone (origin) and terminating to each output study zone (destination) as specified by the input parameters.	How many devices traveled from Vancouver (Origin) to Burnaby (Detination) on 1st May, 2022 between 9 AM and 1 PM.
OD Matrix	OD Matrix end-point performs travel analysis (people movement analysis) between two or more study areas. It returns the count of devices that traveled along with the total no. of trips between the matrix (select study zones/areas) as specified by the input parameters.	No. of devices traveled from Vancouver (Origin) to Burnaby (Destination) and vice versa i.e. no. of devices that traveled from Burnaby (Origin) to Vancouver (Destination) along with the toal no. of trips on April 10, 2022 between 9 AM and 1 PM.
Dwell Time	Returns the unqiue number of devices available based on their dwell times in the input study zone as specified by the input parameters.	How many devices spent between 30 to 90 minutes in Vancouver on May 1, 2022 between 9 AM and 1 PM.
Total Trips	Returns the total number of trips made by devices to a study zone over a give period of time based on the input parameters.	How many trips did devices take to Vancouver on April 1, 2022 between 9 AM and 1 PM.
Work	Returns the count of devices available in each input study zone broken-down by their corresponding assumed Work neighbourhood (output study zone) as specified by the input parameters.	How many devices were at Burnaby (visiting location) on May 1, 2022 between 9 AM and 1 PM whose assumed Work neighbourhood was Vancouver.
Home	Returns the counts of devices available in each input study zone broken-down by their corresponding assumed Home Location (output study zone) as specified by the input parameters.	How many devices were at Burnaby (visting location) on May 1, 2022 between 9 AM and 1 PM whose assumed Home Location was Vancouver.
Demographic	Provides the probalistic demographic breakdown based on the census data of the assumed Home Location of the devices that were available in the study zone specified under \"input geo-id\" and the input parameters.	What is the age range wise percentage of people available in Vancouver on May 1, 2022 between 9 AM and 2 PM.
Repeat Visitation	Returns the number of unique devices available in the study zone more than once as specified by the input parameters.	How many devices went to Vancouver on May 1, 2022 more than once between 9 AM and 1 PM.
Trade Area	Returns for each study zone selected in \"output geo-id\", a list of classification (Primary/Secondary/Tertiary) for the study zone selected in \"input geo-id\".	What would the trade category of Vancouver and Abbotsford for business in Surrey.

API Descriptions - Destination

Description

Destination end-point returns the count of devices with trips originating from each input study zone and terminating to each output study zone as specified by the input parameters.

Study zone specified within the “input geo-id” is considered to be the Origin whereas the study zone specified within the “output geo-id” is considered to be the Destination.

For a device to be qualified in the output, the trip must start (originate) and end (terminate) between the specified start and end times.

Pass-through

In addition to the above, Destination end-point also provides an option to select pass-through study zones.

With pass-through study zone(s) selected, Destination end-point will return the count of devices with trips originating from the study zone selected under input geo-id, passing through the study zones(s) selected pass-through geo-id and terminating to study zone selected under output geo-id.

In case of multiple study zones selected under pass-through, the sequence of the trip will be determined based on the order in which the pass-through study zones have been selected.

Consider a scenarion wherein two study zones 'A' and 'B' have been selected under pass-through geo-id. The output would only contain the count of devices which travelled from Origin->A->B->Destination. Devices travelling through an alterate route from Origin to Destination for e.g., Origin->A->Destination or Origin->B->Destination or Origin->B->A->Destination will not be included in the output.

Example

How many devices travelled from Vancouver (Origin) to Burnaby (Destination) on May 1, 2022 between 9 AM and 1 PM.

How many devices travelled from Vancouver (Origin) to Surrey (Destination) via Burnaby (Pass-through) on May 1, 2022 between 9 AM and 1 PM.

Dwell Time

Minimum and Maximum Dwell Times can be specified independently for study zones within each group i.e. Origin, Destination and Pass-through study zones or can be specified globally which will be applied to all the study zones across all groups.

Consider a device traveling from Vancouver to Burnaby dwelled for 30 minutes in Vancouver as well as Burnaby.

In this case, if the Minimum Dwell Time is set to anything in excess of 30 minutes, this device will be excluded from the output; similarly, if the Maximum Dwell Time is set to anything less than 30 minutes will also exclude this device from the output.

Exclusions

Exclusion Types selected will remove the devices from the study area considered to the Destination.

Consider a resident device of Vancouver who traveled from Vancouver to Burnaby during the specified study period. In this case, excluding ‘Residents’ will exclude the device from the output.

Bucketing

Devices are bucketed based on when the trip originated from the study area considered to be the Origin.

Consider a case wherein the Start Time and End Time are specified as 9 AM and 1 PM respectively, and the Time Bucket Size is set to 120 minutes; output will be comprised of two buckets: Bucket 1 from 9 AM to 11 AM and Bucket 2 from 11 AM to 1 PM. Device traveling from Vancouver to Burnaby started from Vancouver at 10:30 AM reached Burnaby at 12:30 PM.

In this case, the device will be forming a part of output under Bucket 1.

API Descriptions - Demographic

Description

Demographic end-point provides the probabilistic demographic breakdown based on the census data of the Home Location of the devices that were available in the study zone specified under “input geo-id” and the input parameters.

Topics

Following are the topics available within the Demographic end-point which could be selected as an input parameter:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Topic	Examples Characteristic	Example Value
Marital Status	Married Divorced Living Common Law	45% 35% 20%
Age characteristics	20 to 24 years 35 to 39 years	10% 25%
First official language spoken	English French	50% 35%
Family characteristics - Family size	2 persons 3 persons	45% 35%
Household and dwelling characteristics - Household size	Apartment Detached house Semi-detached house	42% 16% 26%
Income of households in 2015 - Household total income groups in 2015 for private households	$10,000 to $14,999 $50,000 to $59,999	12% 44%

Example

What is the age range wise percentage of people available in Vancouver on May 01, 2022 between 9 AM and 2 PM.

API Descriptions - Dwell Time

Dwell Time end-point returns the unique number of devices available based on their dwell times in the input study zone as specified by the input parameters.

Similar to Unique end-point, Dwell Time end-point analyzes each zone independently and hence contains only \"input geo-id\" as an input.

Example

How many devices spent between 30 to 90 minutes in Vancouver on May 1, 2022 between 9 AM and 1 PM.

Dwell Time

Minimum and Maximum Dwell Times are applied to the study zone specified under \"input geo-id\".

Note: Specifying Maximum Dwell Time is mandatory for Dwell Time end-point.

Consider a device was available at Vancouver for 40 minutes during the specified study period.

In this case, if the Minimum Dwell Time is set to anything in excess of 40 minutes irrespective of the Maximum Dwell Time specified, the device will be excluded from the output; similarly, if the Maximum Dwell Time is set to anything less than 40 minutes, this device will be excluded from the output.

Dwell Time is calculated for each independent event and not cumulated for a device based on study period. Consider a case wherein device was available twice at Vancouver; initially from 9:00 AM to 9:30 AM (dwell time of 30 minutes) and then again from 12:15 to 1:05 PM (dwell time 50 minutes). Both these occurrences are considered to be two independent events.

In this case, if the Maximum Dwell Time is set to 40 minutes, this device will be forming a part of the output due to the first event from 9 AM to 9:30 AM. In the second query, if the Minimum Dwell Time is set to 40 minutes and Maximum Dwell Time is set to 60 minutes, the same device will again be forming a part of the output, this time due to the second event from 12:15 PM to 1:05 PM.

If the Minimum Dwell Time is set to 30 minutes and the Maximum Dwell Time is set to 60 minutes, there's a probability wherein both these events will be forming a part of the output which is further explained under Dwell Time Bucketing below.

Dwell Time Bucketing

Dwell Time Bucket Size will bucket the devices based on their dwell times.

Note: Specifying Dwell Time Bucket Size is mandatory for Dwell Time end-point and the value cannot be more than the Maximum Dwell Time.

Consider a case wherein the Start Time and End Time are specified as 9 AM and 1 PM respectively, Minimum and Maximum Dwell Times are specified as 30 and 60 respectively and the Dwell Time Bucket is specified as 15; output will be comprised of two dwell buckets: Dwell Time Bucket 1 from 30 minutes to 45 minutes and Dwell Time Bucket 2 from 46 minutes to 60 minutes.

A device was available twice at Vancouver; initially from 9:00 AM to 9:30 AM (dwell time of 30 minutes) and then again from 12:15 PM to 1:05 PM (dwell time of 50 minutes). Both these occurrences are considered to be two independent events.

In the above scenario, the same device will be forming a part of both the Dwell Time Buckets. Bucket 1 due to event 1 from 9:00 AM to 9:30 AM and under Bucket 2 due to event 2 from 12:15 PM to 1 PM.

Bucketing

Devices are bucketed based on their dwell start time in the study zone.

Considering the same scenario mentioned under Dwell Time Bucketing section above with a Time Bucket Size of 120 minutes; the output will be comprised of 4 buckets (two time buckets and two dwell time buckets; one for each time bucket) as depicted wiht the help of a table below:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Time Bucket Size	Dwell Time From	Dwell Time To
9 AM to 11 AM	30	45
9 AM to 11 AM	46	60
11 AM to 1 PM	30	45
11 AM to 1 PM	46	6

The output will be as follows:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Time Bucket Size	Dwell Time From	Dwell Time To	Count	Reason
9 AM to 11 AM	30	45	1	Event 1 start time is 9:00 AM and hence falls under Time Bucket 9 AM to 11 AM and the device dwelled for 30 minutes and hence falls under Dwell Time Bucket 30 to 45
9 AM to 11 AM	46	60	0
11 AM to 1 PM	30	45	0
11 AM to 1 PM	46	6	1	Event 2 start time is 12:15 PM and hence falls under Time Bucket 11 AM to 1 PM and device dwelled for 50 minutes and hence falls under Dwell Bucket 46 to 60

Exclusions

Based on Exclustion Type selected, devices will be identified and removed from the study area selected under \"inpute geo-id\".

Consider a scenario wherein Dwell Time Analysis is required to be conducted for the devices who are identified as Workers in Vancouver. In this case, excluding 'Non-Workers' will provide the required output.

API Descriptions - Home

Description

The Home end-point returns count of devices available in each input study zone broken-down by their corresponding Home Location as specified by the input parameters.

Study zone specified within the \"input geo-id\" is considered to be the visiting location whereas the study zone specified within the \"output geo-id\" is considered to be the Home location.

All the devices available in the visiting location between the specified start and end times will be qualified to be forming a part of the output.

Example

How many devices were at Burnaby (Visiting Location) on May 1, 2022 between 9 AM and 1 PM whose Home Location was Vancouver.

Dwell Time

Minimum and Maximum Dwell Time is only applied to the study zone specified within the “input geo-id” i.e. the study zone considered to be the Visiting Location.

Consider a resident device of Vancouver was at Burnaby for 20 minutes during the specified study period.

In this case, if the Minimum Dwell Time is set to anything in excess of 20 minutes, this device will be excluded from the output; similarly, if the Maximum Dwell Time is set to anything less than 20 minutes will also exclude this device from the output.

Exclusions

Based on the Exclusion Types selected, devices will be identified and removed from the study area considered to be the Visiting Location.

Consider a resident device of Vancouver who’s work location is Burnaby and was at Burnaby during the specified study period. In this case, excluding ‘Workers’ will exclude this device from the output.

Bucketing

Devices are bucketed based on their availability in the study zone considered to be the Visiting Location.

Consider a case wherein the Start Time and End Time are specified as 9 AM and 1 PM respectively, and the Time Bucket Size is set to 120 minutes; output will be comprised of two buckets: Bucket 1 from 9 AM to 11 AM and Bucket 2 from 11 AM to 1 PM. Resident device of Vancouver was available at Burnaby from 10 AM to 10:20 AM.

In this case, this device will be forming a part of output under Bucket 1.

API Descriptions - OD Matrix

Description

OD Matrix end-point performs travel analysis (people movement analysis) between two or more study areas. It provides the number of devices that traveled along with the total no. of trips between the matrix (selected study zones/areas) as specified by the input parameters.

At least two study zones must be selected as a part of “input geo-id”.

Example

No. of devices traveled from Vancouver (Origin) to Burnaby (Destination) and vice versa i.e. no. of devices that traveled from Burnaby (Origin) to Vancouver (Destination) along with the total no. of trips on April 10 2022 between 9 AM and 1 PM.

Dwell Time

Minimum and Maximum Dwell Times will be applied to both the study areas i.e. Origin as well as Destination.

Consider a device traveling from Vancouver to Burnaby dwelled for 15 minutes in Vancouver and 20 minutes in Burnaby.

In this case, if Minimum Dwell Time is set to anything in excess of 20 minutes, this trip will be excluded from the output; similarly, if the Maximum Dwell Time is set to anything less than 15 minutes will also exclude this trip from the output.

Exclusions

Exclusion Types selected will remove devices from the study area considered to be the Origin.

Consider a resident device of Vancouver who traveled from Vancouver to Burnaby and from Burnaby back to Vancouver.

In this case, excluding ‘Residents’ will exclude this device while calculating the trips from Vancouver (considered as Origin) to Burnaby (considered as Destination) but will be considered in the output while calculating the trips from Burnaby (considered as Origin) to Vancouver (considered as Destination).

Bucketing

Trips are bucketed based on when the trip originated from the study area considered to be the Origin.

In this case, the trip will be forming a part of output under Bucket 1 for Origin: Vancouver and Destination: Burnaby.

API Descriptions - Origin

Description

Origin end-point returns the count of devices with trips originating from each output study zone and terminating to each input study zone as specified by the input parameters.

Study zone specified within the “input geo-id” is considered to be the Destination whereas the study zone specified within the “output geo-id” is considered to be the Origin.

For a device to be qualified in the output, the trip must start (originate) and end (terminate) between the specified start and end times.

Pass-through

In addition to the above, Origin end-point also provides an option to select pass-through study zones.

With pass-through study zone(s) selected, Origin end-point will return the count of devices with trips originating from the study zone selected under output geo-id, passing through the study zones(s) selected pass-through geo-id and terminating to study zone selected under input geo-id.

In case of multiple study zones selected under pass-through, the sequence of the trip will be determined based on the order in which the pass-through study zones have been selected.

Example

How many devices traveled from Vancouver (Origin) to Burnaby (Destination) on May 1, 2022 between 9 AM and 1 PM.

How many devices travelled from Vancouver (Origin) to Surrey (Destination) via Burnaby (Pass-through) on May 1, 2022 between 9 AM and 1 PM.

Dwell Time

Consider a device traveling from Vancouver to Burnaby dwelled for 30 minutes in Vancouver as well as Burnaby.

Exclusions

Exclusion Types selected will remove devices from the study area considered to be the Destination.

Consider a resident device of Burnaby who traveled from Vancouver to Burnaby during the specified study period. In this case, excluding ‘Residents’ will exclude this device from the output.

Bucketing

Devices are bucketed based on when the trip terminated (i.e. reached the Destination study zone).

Consider a case wherein the Start time and End time are specified as 9 AM and 1 PM respectively, and the Time Bucket Size is set to 120 minutes; output will be comprised of two buckets: Bucket 1 from 9 AM to 11 AM and the Bucket 2 from 11 AM to 1 PM. Device traveling from Vancouver to Burnaby started from Vancouver at 10:30 AM reached Burnaby at 12:30 PM.

In this case, this device will be forming a part of output under Bucket 2.

API Descriptions - Repeat Visitation

Description

Repeat Visitation end-point returns the number of unique devices available in the study zone more than once based on specified by the input parameters.

Repeat Visitation end-point like Unique end-point analyzes each study zone independently and hence only contains “input geo-id” as an input.

All the devices available in the study zone more than once i.e. has more than one independent event and each event between the specified start and end times will be qualified to be forming a part of the output. This is further explained under Dwell Time section below.

Example

How many devices went to Vancouver on May 1, 2022 more than once between 9 AM and 1 PM.

Dwell Time

Minimum and Maximum Dwell Time is applied to the study zone specified within “input geo-id”.

Consider a case wherein a device was available twice at Vancouver; initially from 9:00 AM to 9:20 AM (dwell time 20 minutes) and then again from 12:15 PM to 1 PM (dwell time 45 minutes). Both these occurrences are considered to be two independent events and hence the device will be qualified to be forming a part of the output.

In the above case, if Minimum Dwell Time is set to anything in excess of 20 minutes, the device will be excluded from the output; similarly, if the Maximum Dwell Time is set to anything less than 45 minutes will also exclude this device from the output.

Bucketing

Devices are bucketed based on their availability in the study zone.

Consider a case wherein the Start Time and End Time are specified as 9 AM and 1 PM respectively, and the Time Bucket Size is set to 120 minutes; output will be comprised of two buckets: Bucket 1 from 9 AM to 11 AM and Bucket 2 from 11 AM to 1 PM. Device was available at Vancouver from 9:30 AM to 10 AM and then again from 12:30 PM to 1 PM.

In this case, this device will be forming a part of output under both of these buckets.

Consider a different scenario wherein a device was available at Vancouver from 9:30 AM to 10 AM and then again from 10:30 AM to 10:45 AM; in this case, the device will be forming a part of the output only under Bucket 1.

API Descriptions - Total Trip

Description

Total Trip end-point returns the total number of trips made by devices to a study zone over a given period of time based on the input parameters.

Similar to Unique and Repeat Visitation end-points, Total Trip end-point analyzes each study zone independently and hence contains only “input geo-id” as an input.

Example

How many trips did devices take to Vancouver on April 1, 2022 between 9 AM and 1 PM.

Dwell Time

Minimum and Maximum Dwell Time is applied to the study zone specified within “input geo-id”.

Consider a device who took a trip to Vancouver was available at Vancouver for 20 minutes during the specified study period i.e. entered Vancouver at 9:00 AM and left Vancouver at 9:20 AM.

In this case, if the Minimum Dwell Time is set to anything in excess of 20 minutes, the trip made by this device will be excluded from the output; similarly, if the Maximum Dwell Time is set to anything less than 20 minutes will also exclude the trip made by this device from the output.

Dwell Time is calculated for each independent trip (event). Consider a case wherein a device took two trips to Vancouver during the specified study period; first trip/event from 9 AM to 9:20 AM (dwell time of 20 minutes) and the second trip/event from 12:15 PM to 1 PM (dwell time of 45 minutes).

In this case, if the Maximum Dwell Time is set to 30 minutes, only the first trip will be forming a part of the output. In the second query, if the Minimum Dwell Time is set to 30 minutes, only the second trip will be forming a part of the output.

Now consider a case wherein Minimum Dwell Time is set to 15 minutes and Maximum Dwell Time is set to 60 minutes. In this case, both the trips will be included in the output.

Exclusions

Based on Exclusion Type selected, devices will be identified and removed from the study area selected under “input geo-id’.

Consider a resident device of Vancouver who travelled in and out of Vancouver multiple times during the specified study period. In this case, excluding ‘Residents’ will exclude all the trips made by this device from the output.

Bucketing

Trips are bucketed based on when the device entered the study zone.

Consider a case wherein the Start Time and End Time are specified as 9 AM and 1 PM respectively, and the Time Bucket Size is set to 120 minutes; output will be comprised of two Buckets: Bucket 1 from 9 AM to 11 AM and Bucket 2 from 11 AM to 1 PM. Device took a trip to Vancouver, entered Vancouver at 9 AM and left Vancouver at 12:30 PM.

In this case, this trip will be forming a part of the output under Bucket 1.

API Descriptions - Trade Area

Description

A trade area is a geographic area from which a community/business generates the majority of its customers.

Trade Area end-point returns for each study zone selected in “output geo-id”, a list of classification (Primary/Secondary/Tertiary) for the study zone selected in “input geo-id”.

Trade Area defines where customers live (output geo-id) and how far they are likely to travel to a particular business district/area (input geo-id).

Trade Area is built using a weighted function that takes into account the following parameters to calculate a score between 0 and 1 for each of the study zones selected under output geo-id:

• Count Weight: is a 0 to 1 scale and represents how important the unique count is in classifying if the study zone is Primary, Secondary or Tertiary
• Trip Weight: is a 0 to 1 scale and represents how important total number of trips are in classifying if the study zone is Primary, Secondary or Tertiary
• Distance Weight: is a 0 to 1 scale and represents how important distance is in classifying if the study zone is Primary, Secondary and Tertiary

Primary and Secondary Threshold sets the bounds at which the equation will separate out the Primary, Secondary and Tertiary zones.

The classification/category for a particular study zone selected under “output geo-id” is relative to the study zone selected under “input geo-id” and based upon the other study zones selected under “output geo-id”. If only one study zone is selected under “output geo-id”, Trade Area end-point will always return the category as ‘Primary’ as the score for one study zone will always be 1.

Trade Area end-point works best when the sum of Count Weight, Trip Weight and Distance Weight is 1.

Example

Consider a scenario wherein 100 resident devices of Victoria and 300 resident devices of Vancouver were at business district Surrey between the study period selected. Classification of Victoria and Vancouver study zones for business district Surrey based on Count Weight 1, Primary Threshold 0.8 and Secondary Threshold 0.5 will be as follows:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Input Geo-ID	Output Geo-ID	Category
Surrey	Victoria	Tertiary
Surrey	Vancouver	Secondary

Consider a scenario wherein a total of 150 trips were made by resident devices of Victoria and 800 trips were made by resident devices of Vancouver to business district Surrey between the study period selected. Classification of Victoria and Vancouver study zones for business district Surrey based on Count Weight 1, Primary Threshold 0.8 and Secondary Threshold 0.3 will be as follows:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Input Geo-ID	Output Geo-ID	Category
Surrey	Victoria	Tertiary
Surrey	Vancouver	Primary

API Descriptions - Unique

Description

Unique end-point returns the number of unique devices available in the input study zone based on the input parameters.

Unique end-point analyzes each study zone independently and hence only contains “input geo-id” as an input as compared to some of the other end-points like Home, OD matrix etc. wherein study zone specified as a part of “input geo-id” is analyzed based on it’s dependency on study zone specified as a part of “output geo-id”.

All the devices available in the input study zone between the specified start and end times will be qualified to be forming a part of the output.

Example

How many unique devices visited Vancouver on May 1, 2022 between 9 AM and 1 PM.

Dwell Time

Minimum and Maximum Dwell Times are applied to the study zone specified within “input geo-id”.

Consider a device was available at Vancouver for 20 minutes during the specified study period.

Dwell Time is calculated for each independent event and not cumulated for a device based on study period. Consider a case wherein a device was available twice at Vancouver; initially from 9:00 AM to 9:20 AM (dwell time 20 minutes) and then again from 12:15 PM to 1 PM (dwell time 45 minutes). Both these occurrences are considered to be two independent events.

In this case, if the Maximum Dwell Time is set to 30 minutes, this device will be forming a part of the output due to the first event from 9 AM to 9:20 AM. In the second query, if the Minimum Dwell Time is set to 30 minutes, the same device will again be forming a part of the output, this time due to the second event from 12:15 PM to 1 PM.

For further clarification, Unique end-point returns number of unique devices and not the number of unique events and hence, even if a device has two independent events and they both qualify to be forming a part of the output based on specified input parameters, the device will only be counted once in the output.

Consider a case wherein the Minimum Dwell Time is set to 15 minutes and Maximum Dwell
Time is set to 60 minutes. In this case, both the events mentioned above are eligible to be forming a part of the output, but this device will only be considered once in the output.

Bucketing

Devices are bucketed based on their availability in the study zone.

Consider a case wherein the Start Time and End Time are specified as 9 AM and 1 PM respectively, and the Time Bucket Size is set to 120 minutes; output will be comprised of two buckets: Bucket 1 from 9 AM to 11 AM and Bucket 2 from 11 AM to 1 PM. Device was available at Vancouver from 9:30 AM to 12:30 PM.
In this case, this device will be forming a part of output under both of these buckets.

Consider a different scenario wherein a device was available at Vancouver only from 9:30 AM to 10 AM; in this case, the device will be forming a part of the output only under Bucket 1.

API Descriptions - Work

Description

The Work end-point returns count of devices available in each input study zone broken-down by their corresponding Work Location as specified by the input parameters.

Study zone specified within the \"input geo-id\" is considered to be the Visiting Location whereas the study zone specified within the \"output geo-id\" is considered to be the Work Location.

All the devices available in the visiting location between the specified start and end times will be qualified to be forming a part of the output.

Example

How many devices were at Burnaby (Visiting Location) on May 1, 2022 between 9 AM and 1 PM whose Work Location was Vancouver.

Dwell Time

Minimum and Maximum Dwell Time is only applied to the study zone specified within the “input geo-id” i.e. study zone considered to be the Visiting Location.

Consider a resident device of Vancouver was at Burnaby for 20 minutes during the specified study period.

Exclusions

Based on the Exclusion Types selected, devices will be identified and removed from the study area considered to be the Visiting Location.

Consider a device who’s work location is Vancouver and is a resident device of Burnaby and was at Burnaby during the specified study period. In this case, excluding ‘Residents’ will exclude this device from the output.

Bucketing

Devices are bucketed based on their availability in the study zone considered to be the Visiting Location.

Consider a case wherein the Start Time and End Time are specified as 9 AM and 1 PM respectively, and the Time Bucket Size is set to 120 minutes; output will be comprised of two buckets: Bucket 1 from 9 AM to 11 AM and Bucket 2 from 11 AM to 1 PM. Device, who’s work location is Vancouver was available at Burnaby from 10 AM to 10:20 AM.

In this case, this device will be forming a part of output under Bucket 1.

Count - APIs Reference Section

Telus Insights Location API

Version: 1.0
Host: location-api.insights.telus.com/product/insightsRequest/v1
Protocols: https

More Info

Contact Us by Email - TelusInsightsAppSupport@telus.com

We have developed the following API services to help customers utilize TELUS Geo-intelligence data assets and help answer a range of questions around location and movement patterns within Canada.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Introduction - Generalities","slug":"introduction-generalities"},{"content":"Introduction - Spatial aggregation","slug":"introduction-spatial-aggregation"},{"content":"Introduction - Methodologies","slug":"introduction-methodologies"},{"content":"Introduction - Insights Developer Portal","slug":"introduction-insights-developer-portal"},{"content":"Introduction - API Integrations","slug":"introduction-api-integrations"},{"content":"Introduction - API Restrictions and Usage","slug":"introduction-api-restrictions-and-usage"},{"content":"Getting Started","slug":"getting-started"},{"content":"Getting Started - Authentication","slug":"getting-started-authentication"},{"content":"Getting Started - Shapefiles and Study Zones","slug":"getting-started-shapefiles-and-study-zones"},{"content":"Getting Started - Run a job","slug":"getting-started-run-a-job"},{"content":"Getting Started - Data Dictionary and Formats","slug":"getting-started-data-dictionary-and-formats"},{"content":"Getting Started - Exclusion Types","slug":"getting-started-exclusion-types"},{"content":"API Descriptions","slug":"api-descriptions"},{"content":"API Descriptions - Destination","slug":"api-descriptions-destination"},{"content":"API Descriptions - Demographic","slug":"api-descriptions-demographic"},{"content":"API Descriptions - Dwell Time","slug":"api-descriptions-dwell-time"},{"content":"API Descriptions - Home","slug":"api-descriptions-home"},{"content":"API Descriptions - OD Matrix","slug":"api-descriptions-od-matrix"},{"content":"API Descriptions - Origin","slug":"api-descriptions-origin"},{"content":"API Descriptions - Repeat Visitation","slug":"api-descriptions-repeat-visitation"},{"content":"API Descriptions - Total Trip","slug":"api-descriptions-total-trip"},{"content":"API Descriptions - Trade Area","slug":"api-descriptions-trade-area"},{"content":"API Descriptions - Unique","slug":"api-descriptions-unique"},{"content":"API Descriptions - Work","slug":"api-descriptions-work"},{"content":"Count - APIs Reference Section","slug":"count-apis-reference-section"}],"owner":"19774759","collectionId":"d8e042de-3754-42b6-beb6-a174697eddf8","publishedId":"2s93z9cNmr","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"4B286D"},"publishDate":"2023-06-28T21:19:35.000Z"},"item":[{"name":"Create Area","item":[{"name":"upload a shapefile","id":"9d53ddd4-56af-4d91-9196-ec8589d1fe06","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"POST","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Content-Type","value":"binary"},{"key":"Accept","value":"application/json"}],"body":{"mode":"file","file":{}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile","description":"

Upload a shapefile and recieve a requestID.

Acceptable file include .kml (Google Keyhole Markup), .zip (ESRI Shapefile) and .json

Within the shapefile each polygon 1) Must have geometry information 2) Must have 'study_zone' in the properties 3) 'study_zone' must NOT contain backslashes or quotation marks

\n","urlObject":{"path":["shapefile"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"882ec1dc-3406-410a-b309-e43954a84b96","name":"Request Created. Please check the link with link relation check_status to find out if the result is ready for cunsumption.","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"file","file":{}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"description\": \"Shapefile is uploaded successfully\",\n \"link\": {\n \"rel\": \"status\",\n \"url\": \"/shapefile/c764703b-2043-48ff-8929-d18bc50f1a62\"\n },\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\"\n}"},{"id":"5e04ee66-d525-483b-ba3c-bec30b4f96ec","name":"Invalid shapefile. The shapefile could not be opened with GDAL api. At this point there is not request object made, so not request Id","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"file","file":{}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid shapefile.\"\n}"},{"id":"efab694e-fced-4714-9b3d-28c8c0fe9e78","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"file","file":{}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"9d53ddd4-56af-4d91-9196-ec8589d1fe06"}],"id":"10b03993-beda-4ff7-9963-e185c20f70c9","description":"

Used to upload shapefiles

\n","_postman_id":"10b03993-beda-4ff7-9963-e185c20f70c9","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"Demographic","item":[{"name":"post Demographic","id":"cf99eab5-4a9b-47a2-84be-b39130ad1974","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"POST","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"timezone\": \"UTC\",\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"estimation_only\": false,\n \"topics\": [\n {\n \"topic\": \"Main mode of commuting\"\n },\n {\n \"topic\": \"Household characteristics-Private households by age of primary household maintainers\"\n }\n ],\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/demographic","description":"

The probabilistic demographic breakdown of the devices that were in the Input GeoID between the start and End time, based on their home areas for the parameters given by the job corresponding to the Job ID.

Example: What is the count of devices split by age range that were at Trinity Bellwoods area between 1st January 2020 and 15th January 2020?

\n","urlObject":{"path":["count","demographic"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"be80067c-4e3b-4ee6-842e-a59abd86d3ee","name":"Job created for request","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"estimation_only\": false,\n \"topics\": [\n {\n \"topic\": \"Main mode of commuting\"\n },\n {\n \"topic\": \"Household characteristics-Private households by age of primary household maintainers\"\n }\n ],\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/demographic"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"amet Excepteur enim\",\n \"link\": {\n \"rel\": \"aliquip est\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"token_usage\": 8599126.522849992\n}"},{"id":"fef96a3a-48bf-4f7e-beab-380487596779","name":"Invalid Input","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"estimation_only\": false,\n \"topics\": [\n {\n \"topic\": \"Main mode of commuting\"\n },\n {\n \"topic\": \"Household characteristics-Private households by age of primary household maintainers\"\n }\n ],\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/demographic"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"1bc0d742-a46e-41b7-a212-7182fd20a247","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"estimation_only\": false,\n \"topics\": [\n {\n \"topic\": \"Main mode of commuting\"\n },\n {\n \"topic\": \"Household characteristics-Private households by age of primary household maintainers\"\n }\n ],\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/demographic"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"cf99eab5-4a9b-47a2-84be-b39130ad1974"},{"name":"get Demographic","id":"355063e3-4ed4-4af7-86e1-1bed5e8c979f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Accept","value":"application/json"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/demographic/:jobId","description":"","urlObject":{"path":["count","demographic",":jobId"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"31792a13-caa7-40e2-9fe4-7a0920272a61","description":{"content":"

(Required) The request id returned from POST request

\n","type":"text/plain"},"type":"any","value":"velit tempor","key":"jobId"}]}},"response":[{"id":"6022ccac-9a2c-4ea4-8e4b-82dde83e0858","name":"response","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/demographic/:jobId","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","count","demographic",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zones\": [\n {\n \"input_geoid\": \"Kelowna\",\n \"topics\": [\n {\n \"topic\": \"Main mode of commuting\",\n \"characteristics\": [\n {\n \"characteristic\": \"Car\",\n \"percentage\": 20,\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"characteristic\": \"Public transit\",\n \"percentage\": 20,\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"characteristic\": \"Walked\",\n \"percentage\": 20,\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"characteristic\": \"Bicycle\",\n \"percentage\": 20,\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"characteristic\": \"Other method\",\n \"percentage\": 20,\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n },\n {\n \"topic\": \"Household characteristics-Private households by age of primary household maintainers\",\n \"characteristics\": [\n {\n \"characteristic\": \"15 to 24 years\",\n \"percentage\": 10,\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"characteristic\": \"25 to 34 years\",\n \"percentage\": 10,\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"characteristic\": \"35 to 44 years\",\n \"percentage\": 20,\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"characteristic\": \"45 to 54 years\",\n \"percentage\": 20,\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"characteristic\": \"55 to 64 years\",\n \"percentage\": 10,\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"characteristic\": \"65 to 74 years\",\n \"percentage\": 10,\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"characteristic\": \"75 to 84 years\",\n \"percentage\": 10,\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"characteristic\": \"85 years and over\",\n \"percentage\": 10,\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n }\n ]\n }\n ]\n}"},{"id":"120fe1c2-c7bf-42ca-8699-3fa0cd24baf5","name":"Request was accepted and being processed on.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/demographic/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","demographic",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"voluptate deserunt\",\n \"link\": {\n \"rel\": \"self\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"status\": \"Processing\"\n}"},{"id":"5815c572-b32c-4b67-af99-33c104b25591","name":"Invalid Input","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/demographic/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","demographic",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"a9224ec5-5da6-436a-949e-b5e0d97d0b8a","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/demographic/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","demographic",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"429e8b6a-e361-40cf-b43d-b2df50af7a23","name":"Resource not found","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/demographic/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","demographic",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404,\n \"message\": \"Method does not exist.\"\n}"}],"_postman_id":"355063e3-4ed4-4af7-86e1-1bed5e8c979f"}],"id":"deee18a4-18bb-437e-9c74-fdd5a22d155a","description":"

Get the demographic counts associated to Area ID or a list of Area IDs.

\n","_postman_id":"deee18a4-18bb-437e-9c74-fdd5a22d155a","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"Destination","item":[{"name":"post Destination","id":"6ac65baa-61b3-4efe-869b-c4456e42a8b2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"POST","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ],\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n },\n \"pass_through_geoid\": {\n \"requestId\": \"a7643453703b-23443-4834f-8359-8c50f1a\",\n \"study_zone\": [\n \"Seven Oaks\"\n ],\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n },\n \"timezone\": \"UTC\",\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ],\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n },\n \"time_bucket_size\": 30,\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/destination","description":"

The number of devices with trip destinations at each output study zone for the given parameters defined by the job, which corresponds to the job ID.

Example: How many devices went to Port Credit coming from Brampton on a daily basis between 15th - 18th January 2020

\n","urlObject":{"path":["count","destination"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"41a934b9-45e1-48e2-a64e-7edb7dba7e62","name":"Job created for request","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/destination"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"amet Excepteur enim\",\n \"link\": {\n \"rel\": \"aliquip est\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"token_usage\": 8599126.522849992\n}"},{"id":"1fa2a677-4aaf-4c68-8262-7749a2aee1f5","name":"Invalid Input","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/destination"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"31292b9c-8896-4a1a-bc90-964332a3e2a2","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/destination"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"6ac65baa-61b3-4efe-869b-c4456e42a8b2"},{"name":"get Destination","id":"b96ea8b9-2685-455e-b26b-71a933404134","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Accept","value":"application/json"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/destination/:jobId","description":"","urlObject":{"path":["count","destination",":jobId"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"7b0e6e5a-c3ff-42b9-a0ea-09c52387c0fe","description":{"content":"

(Required) The request id returned from POST request

\n","type":"text/plain"},"type":"any","value":"velit tempor","key":"jobId"}]}},"response":[{"id":"4fc18100-ffef-43b6-ac54-0fc9f831fb78","name":"response","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/destination/:jobId","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","count","destination",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zones\": [\n {\n \"input_geoid\": \"Kelowna\",\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"outputs\": [\n {\n \"count\": 90,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 70,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"outputs\": [\n {\n \"count\": 120,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 80,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n }\n ]\n },\n {\n \"input_geoid\": \"Toronto\",\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"outputs\": [\n {\n \"count\": 60,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 90,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"outputs\": [\n {\n \"count\": 110,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 60,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n }\n ]\n }\n ]\n}"},{"id":"1c593f5b-523e-4b43-ba09-2987d4b4ec74","name":"Request was accepted and being processed on.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/destination/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","destination",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"voluptate deserunt\",\n \"link\": {\n \"rel\": \"self\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"status\": \"Processing\"\n}"},{"id":"cabb4bb2-874c-4dc3-b99f-d726f3639528","name":"Invalid Input","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/destination/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","destination",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"6b6d43a4-be77-48bd-9325-78679000ef37","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/destination/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","destination",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"b92df618-cc21-4178-8df7-27d7d33e1e0b","name":"Resource not found","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/destination/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","destination",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404,\n \"message\": \"Method does not exist.\"\n}"}],"_postman_id":"b96ea8b9-2685-455e-b26b-71a933404134"}],"id":"5053856c-85db-4cbb-8242-83ec8a75520f","description":"

Get the list of areas, with a count that the users in the area dwelled at afterto to the current location

\n","_postman_id":"5053856c-85db-4cbb-8242-83ec8a75520f","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"DwellTime","item":[{"name":"post Dwell Time","id":"da9b56a4-4946-4026-9483-b2e7f74cd8e3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"POST","header":[{"description":"

(Required) CustomerId is required

The unique number of devices that have spent X time within the defined area based on the parameters given by the job corresponding to the Job ID. \nOnly the time between the start and end time parameters is qualified within these counts.

Example: How many devices have spent between 1-4 hours in Kelowna in December of 2019, broken down by day.

\n","urlObject":{"path":["count","dwelltime"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"870a2c34-1678-4872-a317-1a4ab1ab8b75","name":"Job created for request","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Calgary\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"dwell_time_bucket\": 60,\n \"max_dwell_time\": 180,\n \"estimation_only\": true,\n \"bucket_size\": 30,\n \"min_dwell_time\": 15\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/dwelltime"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"amet Excepteur enim\",\n \"link\": {\n \"rel\": \"aliquip est\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"token_usage\": 8599126.522849992\n}"},{"id":"a59ac26e-e3d3-4b5f-b0ee-5e3a0fedcb98","name":"Invalid Input","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Calgary\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"dwell_time_bucket\": 60,\n \"max_dwell_time\": 180,\n \"estimation_only\": true,\n \"bucket_size\": 30,\n \"min_dwell_time\": 15\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/dwelltime"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"b051a727-ceb3-46aa-8add-1e78f5957622","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Calgary\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"dwell_time_bucket\": 60,\n \"max_dwell_time\": 180,\n \"estimation_only\": true,\n \"bucket_size\": 30,\n \"min_dwell_time\": 15\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/dwelltime"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"da9b56a4-4946-4026-9483-b2e7f74cd8e3"},{"name":"get Dwell Time","id":"03b958b2-54dd-4ee2-be9f-cdf87a6cbd92","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

Get count of people who are in the zone based on dwell time

\n","urlObject":{"path":["count","dwelltime",":jobId"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"f12e88d6-9d1b-4287-ae83-59c9ecdc076f","description":{"content":"

(Required) The request id returned from POST request

\n","type":"text/plain"},"type":"any","value":"velit tempor","key":"jobId"}]}},"response":[{"id":"d27385c2-be85-462e-bbda-b5a0d6687e07","name":"response","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/dwelltime/:jobId","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","count","dwelltime",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"time_bucket_size\": 30,\n \"end_time\": \"2020-01-03T01:00:00\",\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"start_time\": \"2020-01-03T00:00:00\",\n \"study_zones\": [\n {\n \"buckets\": [\n {\n \"121-180\": 140,\n \"15-60\": 80,\n \"61-120\": 100,\n \"timeframe_bucket\": \"2020-01-03T00:00:00\"\n },\n {\n \"121-180\": 130,\n \"15-60\": 70,\n \"61-120\": 90,\n \"timeframe_bucket\": \"2020-01-03T00:30:00\"\n }\n ],\n \"input_geoid\": \"Kelowna\"\n },\n {\n \"buckets\": [\n {\n \"121-180\": 70,\n \"15-60\": 90,\n \"61-120\": 150,\n \"timeframe_bucket\": \"2020-01-03T00:00:00\"\n },\n {\n \"121-180\": 80,\n \"15-60\": 80,\n \"61-120\": 130,\n \"timeframe_bucket\": \"2020-01-03T00:30:00\"\n }\n ],\n \"input_geoid\": \"Calgary\"\n }\n ]\n}"},{"id":"6abd5fe1-bf29-4e36-ada1-0d7f76357d7b","name":"Request was accepted and being processed on.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/dwelltime/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","dwelltime",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"voluptate deserunt\",\n \"link\": {\n \"rel\": \"self\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"status\": \"Processing\"\n}"},{"id":"686a982c-1b14-4050-8b65-03dcdd11fe09","name":"Invalid Input","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/dwelltime/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","dwelltime",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"6a3f9f14-0c1c-4624-84f9-f6963e005107","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/dwelltime/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","dwelltime",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"ecc37642-ecab-475f-977c-3e80799df985","name":"Resource not found","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/dwelltime/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","dwelltime",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404,\n \"message\": \"Method does not exist.\"\n}"}],"_postman_id":"03b958b2-54dd-4ee2-be9f-cdf87a6cbd92"}],"id":"aa6ae5d0-4177-4fd9-a751-4b6f28adc659","description":"

Get count of people who are in the zone based on dwell time

\n","_postman_id":"aa6ae5d0-4177-4fd9-a751-4b6f28adc659","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"Geofence","item":[{"name":"get Geofence","id":"5ee7f63c-8395-46ce-9d11-5476fc45e937","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Accept","value":"application/json"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/geofence","description":"

See a list of uploaded shapefiles.

With Partner Id you will get shapes uploaded for partner and also list of shapes for all customers for that Partner Id.

In case of Customer Id, just the shapes for that Customer Id will be returned.

\n","urlObject":{"path":["geofence"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"8ad0021f-c385-46b3-9745-874ebfdd4da9","name":"response","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/geofence"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"customer_shapes\": [\n {\n \"customerId\": \"customerId\",\n \"shapefiles\": [\n {\n \"created_date\": \"2019-05-20T00:00:00\",\n \"input_geoid\": [\n \"in anim culpa\",\n \"ut culpa velit amet exercitation\"\n ],\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\"\n },\n {\n \"created_date\": \"2019-05-20T00:00:00\",\n \"input_geoid\": [\n \"in aute cillum\",\n \"anim ad fugiat officia\"\n ],\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\"\n }\n ]\n },\n {\n \"customerId\": \"customerId\",\n \"shapefiles\": [\n {\n \"created_date\": \"2019-05-20T00:00:00\",\n \"input_geoid\": [\n \"velit\",\n \"id veniam ut Excepteur et\"\n ],\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\"\n },\n {\n \"created_date\": \"2019-05-20T00:00:00\",\n \"input_geoid\": [\n \"dolore\",\n \"laboris proident dolor\"\n ],\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\"\n }\n ]\n }\n ],\n \"partner_shapes\": {\n \"created_date\": \"2019-05-18T00:00:00\",\n \"input_geoid\": [\n \"dolore commodo deserunt irure\",\n \"occaecat deserunt sed\"\n ],\n \"partnerId\": \"partnerId\",\n \"requestId\": \"b03eb5fa-a58d-49c4-939f-e41d242befb0\"\n }\n}"},{"id":"9249eb96-1482-473e-ab4d-cc4af260ce89","name":"Invalid Input","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/geofence"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"85240ae7-58a3-44d6-be1c-e184d2021f5b","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/geofence"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"5ee7f63c-8395-46ce-9d11-5476fc45e937"}],"id":"6930c259-9dba-4522-aad0-dc6f7f5ad5a5","description":"

Get list of polygons from uploaded shapefiles

\n","_postman_id":"6930c259-9dba-4522-aad0-dc6f7f5ad5a5","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"Home","item":[{"name":"post Home","id":"832f4f27-cda2-4790-8967-2487a18a3c08","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"POST","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ]\n },\n \"estimation_only\": false,\n \"time_bucket_size\": 30,\n \"max_dwell_time\": 30,\n \"min_dwell_time\": 15\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/home","description":"

The Home endpoint helps us to understand the Home location of those that are visiting a particular location.

For each study zone that is specified within the input “geo-id”, what are the home locations of the people there.

The home locations are grouped by the output study zones which must be specified as part of the GET request, within the “output-geoid” parameter

Example: For everyone in Whistler on Saturday 31st May 2020, how many of the device's home location is in Squamish.

\n","urlObject":{"path":["count","home"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"e7d86c24-20ef-4279-91ad-bf9d96f40626","name":"Job created for request","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ]\n },\n \"estimation_only\": false,\n \"time_bucket_size\": 30,\n \"max_dwell_time\": 30,\n \"min_dwell_time\": 15\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/home"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"amet Excepteur enim\",\n \"link\": {\n \"rel\": \"aliquip est\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"token_usage\": 8599126.522849992\n}"},{"id":"6dda6b1b-3720-43a1-937a-83cb41032db2","name":"Invalid Input","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ]\n },\n \"estimation_only\": false,\n \"time_bucket_size\": 30,\n \"max_dwell_time\": 30,\n \"min_dwell_time\": 15\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/home"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"0e832e6a-6e2c-4511-85a2-19250e24c24c","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ]\n },\n \"estimation_only\": false,\n \"time_bucket_size\": 30,\n \"max_dwell_time\": 30,\n \"min_dwell_time\": 15\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/home"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"832f4f27-cda2-4790-8967-2487a18a3c08"},{"name":"get Home","id":"23b1b5c5-a2d3-4801-9487-f3c580ff9d6d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

Get count of people who are in the zone based on home location

\n","urlObject":{"path":["count","home",":jobId"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"c2d02af5-9a9e-4209-811b-dde30affe4fd","description":{"content":"

(Required) The request id returned from POST request

\n","type":"text/plain"},"type":"any","value":"velit tempor","key":"jobId"}]}},"response":[{"id":"06510cac-8e73-4f8f-9c93-f3a5fad92262","name":"response","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/home/:jobId","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","count","home",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"time_bucket_size\": 30,\n \"end_time\": \"2020-01-03T01:00:00\",\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"start_time\": \"2020-01-03T00:00:00\",\n \"study_zones\": [\n {\n \"input_geoid\": \"Kelowna\",\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"outputs\": [\n {\n \"count\": 90,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 70,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"outputs\": [\n {\n \"count\": 120,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 80,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n }\n ]\n },\n {\n \"input_geoid\": \"Toronto\",\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"outputs\": [\n {\n \"count\": 60,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 90,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"outputs\": [\n {\n \"count\": 110,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 60,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n }\n ]\n }\n ]\n}"},{"id":"26848771-9b74-46b8-ac6d-69bc001e3f28","name":"Request was accepted and being processed on.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/home/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","home",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"voluptate deserunt\",\n \"link\": {\n \"rel\": \"self\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"status\": \"Processing\"\n}"},{"id":"57b8dabb-e66e-443b-8b41-336e41e3ac42","name":"Invalid Input","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/home/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","home",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"bb02d64a-5b78-490f-aee8-dc441be0d927","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/home/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","home",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"38ccb809-8100-4aff-884e-f0d923d431e0","name":"Resource not found","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/home/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","home",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404,\n \"message\": \"Method does not exist.\"\n}"}],"_postman_id":"23b1b5c5-a2d3-4801-9487-f3c580ff9d6d"}],"id":"20d821b9-a2ce-4410-88f2-a495e3f5d627","description":"

Get count of people in Current(Input) location who have Home in provided(Output) location

\n","_postman_id":"20d821b9-a2ce-4410-88f2-a495e3f5d627","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"Job","item":[{"name":"Delete One Job","id":"1d53cc2f-5451-4c6a-9880-741490f45683","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"grant_type":"","scope":"{{AuthCodeScopeIds}}","clientId":"{{AuthCodeClientId}}","clientSecret":"{{AuthCodeClientSecret}}","accessTokenUrl":"{{AccessTokenURL}}"},"isInherited":false},"method":"DELETE","header":[{"description":"

(Required)

\n","key":"customerid","value":"velit tempor"},{"key":"Accept","value":"*/*"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/job/:jobid","description":"

Delete the jobs that you don't need anymore. These jobs will not show up in the Portal. If you delete a job that is still running, the job will be first cancelled and then deleted.

\n","urlObject":{"path":["job",":jobid"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"1e08d5ca-b608-4f57-8ebb-1183bd8c55f4","type":"any","key":"jobid"}]}},"response":[{"id":"fe32a75e-f2cb-4d60-a87c-74a5ab510f62","name":"response","originalRequest":{"method":"DELETE","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) ","key":"customerid","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/job/:jobid","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","job",":jobid"],"variable":[{"key":"jobid"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"014ff1c9-59de-4a87-9029-c76a1c217e15\",\n \"message\": \"Job Deleted successfully.\"\n}"},{"id":"69e136e5-8324-4635-9683-03a7fd0f9272","name":"response","originalRequest":{"method":"DELETE","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) ","key":"customerid","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/job/:jobid","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["job",":jobid"],"variable":[{"key":"jobid"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"fff01aa9-cebd-46dc-99d5-3eff60d1c385\",\n \"message\": \"We are unable to delete your Job. Please try again in sometime. If the problem pertains please raise a ticket in telus insights support\",\n \"level\": \"error\"\n}"},{"id":"98a12bc9-32fc-4358-9402-1f1c5dc63487","name":"response","originalRequest":{"method":"DELETE","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) ","key":"customerid","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/job/:jobid","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["job",":jobid"],"variable":[{"key":"jobid"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"1d53cc2f-5451-4c6a-9880-741490f45683"},{"name":"Cancel One Job","id":"0b63463a-acfe-4da3-be18-4e080f6018ea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{},"isInherited":false},"method":"PATCH","header":[{"description":"

(Required)

\n","key":"customerid","value":"velit tempor"},{"key":"Accept","value":"*/*"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/job/:jobid/cancel?jobid=velit tempor","description":"

Cancel a running job. You will be able to edit and resubmit if you ran something by mistake.

\n","urlObject":{"path":["job",":jobid","cancel"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[{"description":{"content":"

(Required)

\n","type":"text/plain"},"key":"jobid","value":"velit tempor"}],"variable":[{"id":"3e04af99-f17a-492c-8897-35749a0474a0","type":"any","key":"jobid"}]}},"response":[{"id":"1f73b7be-7b74-43f7-8270-00491328a97b","name":"response","originalRequest":{"method":"PATCH","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) ","key":"customerid","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/job/:jobid/cancel?jobid=velit tempor","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","job",":jobid","cancel"],"query":[{"key":"jobid","value":"velit tempor"}],"variable":[{"key":"jobid"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"fff01aa9-cebd-46dc-99d5-3eff60d1c385\",\n \"status\": \"CANCELLED\",\n \"message\": \"Job cancelled successfully.\"\n}"},{"id":"16437d1c-d449-4387-abb7-156f2cbdece5","name":"response","originalRequest":{"method":"PATCH","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) ","key":"customerid","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/job/:jobid/cancel?jobid=velit tempor","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["job",":jobid","cancel"],"query":[{"key":"jobid","value":"velit tempor"}],"variable":[{"key":"jobid"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"fff01aa9-cebd-46dc-99d5-3eff60d1c385\",\n \"message\": \"Job could not be cancelled. It may be because the job is already Complete.\",\n \"level\": \"error\"\n}"},{"id":"3dca38da-9857-4989-9201-272a9081b780","name":"response","originalRequest":{"method":"PATCH","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) ","key":"customerid","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/job/:jobid/cancel?jobid=velit tempor","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["job",":jobid","cancel"],"query":[{"key":"jobid","value":"velit tempor"}],"variable":[{"key":"jobid"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{}"}],"_postman_id":"0b63463a-acfe-4da3-be18-4e080f6018ea"},{"name":"List User Jobs","id":"1ade3e9e-af2f-4450-b914-3a3088d6f0db","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{},"isInherited":false},"method":"GET","header":[{"key":"customerId","value":"velit tempor","type":"text"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/job?limit=5&offset=0&sort=-createdDate&selectjobs=user","description":"

This endpoint returns the active jobs irrespective of the status of the job based on the following query parameters.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Passed in	Description	Example
limit (optional)	query	The limit value defines the number of records to be fetched. The default value is 15.	limit=5
offset (optional)	query	The offset value defines the number of records to be skipped (which would have already been fetched). The default value is 0.	offset=10
sort (optional)	query	The sort value defines the field using which you want the records to be sorted. Currently we support the following 3 fields for sort: createdDate, api (job/study type), and status. The default sort is based on createdDate field in descending order. The hyphen symbol (-) just before the sort field will sort the data in descending order. For sorting in an ascending order, the hyphen symbol will have to be removed.	sort=-status sort=status
selectjobs (optional)	query	The selectjobs value defines the list of the jobs to be returned i.e. list of jobs submitted by the user or the list of all the jobs pertaining to the organization) Allowed values: user, organization. The default value is user.	selectjobs=organization

","urlObject":{"path":["job"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[{"key":"limit","value":"5"},{"key":"offset","value":"0"},{"key":"sort","value":"-createdDate"},{"key":"selectjobs","value":"user"}],"variable":[]}},"response":[{"id":"353123ad-c3cc-445f-a968-ae0e4cf2bf93","name":"Success - Paginated list of jobs","originalRequest":{"method":"GET","header":[{"key":"customerId","value":"velit tempor","type":"text"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/job?limit=5&offset=0&sort=-createdDate","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","job"],"query":[{"key":"limit","value":"5"},{"key":"offset","value":"0"},{"key":"sort","value":"-createdDate"}]}},"status":"Partial Content","code":206,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"_metadata\": {\n \"page\": 1,\n \"per_page\": 5,\n \"page_count\": 5,\n \"total_count\": 16,\n \"range\": \"1-5/16\",\n \"links\": [\n {\n \"self\": \"/job?limit=5&offset=0&sort=-createdDate\"\n },\n {\n \"first\": \"/job?limit=5&offset=0&sort=-createdDate\"\n },\n {\n \"last\": \"/job?limit=5&offset=15&sort=-createdDate\"\n },\n {\n \"next\": \"/job?limit=5&offset=5&sort=-createdDate\"\n }\n ]\n },\n \"records\": [\n {\n \"jobId\": \"velit tempor1\",\n \"api\": \"demographic\",\n \"status\": \"COMPLETE\",\n \"queryParams\": {\n \"end_time\": \"2020-10-04T23:59:59\",\n \"input_geoid\": {\n \"study_zone\": [\n \"Downtown\",\n \"Inkster\",\n \"Seven Oaks\",\n \"River Heights\",\n \"Point Douglas\",\n \"Transcona\",\n \"St. Boniface\",\n \"River East\",\n \"St. Vital\",\n \"Fort Garry\",\n \"Assiniboine South\",\n \"St. James - Assiniboia\"\n ],\n \"requestId\": \"shape-file-zip-12150800-8b49a4acbc1d\"\n },\n \"time_bucket_size\": 1440,\n \"api\": \"demographic\",\n \"topics\": [\n {\n \"topic\": \"Marital status\"\n },\n {\n \"topic\": \"Age characteristics\"\n },\n {\n \"topic\": \"First official language spoken\"\n },\n {\n \"topic\": \"Family characteristics-Family size\"\n },\n {\n \"topic\": \"Household and dwelling characteristics-household size\"\n },\n {\n \"topic\": \"Income of households in 2015-Household total income groups in 2015 for private households\"\n }\n ],\n \"start_time\": \"2020-10-04T00:00:00\"\n },\n \"created_date\": \"2022-10-31T11:27:59\"\n },\n {\n \"jobId\": \"velit tempor2\",\n \"api\": \"demographic\",\n \"status\": \"COMPLETE\",\n \"queryParams\": {\n \"start_time\": \"2020-10-04T00:00:00\",\n \"api\": \"demographic\",\n \"time_bucket_size\": 1440,\n \"end_time\": \"2020-10-04T23:59:59\",\n \"topics\": [],\n \"input_geoid\": {\n \"requestId\": \"shape-file-zip-12150800-8b49a4acbc1d\",\n \"study_zone\": [\n \"Downtown\",\n \"Inkster\",\n \"Seven Oaks\",\n \"River Heights\",\n \"Point Douglas\",\n \"Transcona\",\n \"St. Boniface\",\n \"River East\",\n \"St. Vital\",\n \"Fort Garry\",\n \"Assiniboine South\",\n \"St. James - Assiniboia\"\n ]\n }\n },\n \"created_date\": \"2022-10-31T11:26:46\"\n },\n {\n \"jobId\": \"velit tempor3\",\n \"api\": \"demographic\",\n \"status\": \"COMPLETE\",\n \"queryParams\": {\n \"end_time\": \"2020-10-04T23:59:59\",\n \"topics\": [],\n \"time_bucket_size\": 1440,\n \"api\": \"demographic\",\n \"start_time\": \"2020-10-04T00:00:00\",\n \"input_geoid\": {\n \"requestId\": \"shape-file-zip-12150800-8b49a4acbc1d\",\n \"study_zone\": [\n \"Downtown\",\n \"Inkster\",\n \"Seven Oaks\",\n \"River Heights\",\n \"Point Douglas\",\n \"Transcona\",\n \"St. Boniface\",\n \"River East\",\n \"St. Vital\",\n \"Fort Garry\",\n \"Assiniboine South\",\n \"St. James - Assiniboia\"\n ]\n }\n },\n \"created_date\": \"2022-10-31T11:22:51\"\n },\n {\n \"jobId\": \"velit tempor4\",\n \"api\": \"repeatvisitation\",\n \"status\": \"COMPLETE\",\n \"queryParams\": {\n \"time_bucket_size\": 1440,\n \"end_time\": \"2020-10-04T23:59:59\",\n \"min_dwell_time\": 15,\n \"input_geoid\": {\n \"study_zone\": [\n \"Downtown\",\n \"Inkster\",\n \"Seven Oaks\",\n \"River Heights\",\n \"Point Douglas\",\n \"Transcona\",\n \"St. Boniface\",\n \"River East\",\n \"St. Vital\",\n \"Fort Garry\",\n \"Assiniboine South\",\n \"St. James - Assiniboia\"\n ],\n \"requestId\": \"shape-file-zip-12150800-8b49a4acbc1d\"\n },\n \"api\": \"repeatvisitation\",\n \"start_time\": \"2020-10-04T00:00:00\"\n },\n \"created_date\": \"2022-10-31T07:28:08\"\n },\n {\n \"jobId\": \"velit tempor5\",\n \"api\": \"repeatvisitation\",\n \"status\": \"COMPLETE\",\n \"queryParams\": {\n \"input_geoid\": {\n \"requestId\": \"shape-file-zip-12150800-8b49a4acbc1d\",\n \"study_zone\": [\n \"Downtown\",\n \"Inkster\",\n \"Seven Oaks\",\n \"River Heights\",\n \"Point Douglas\",\n \"Transcona\",\n \"St. Boniface\",\n \"River East\",\n \"St. Vital\",\n \"Fort Garry\",\n \"Assiniboine South\",\n \"St. James - Assiniboia\"\n ]\n },\n \"api\": \"repeatvisitation\",\n \"start_time\": \"2020-10-04T00:00:00\",\n \"end_time\": \"2020-10-04T23:59:59\",\n \"time_bucket_size\": 1440\n },\n \"created_date\": \"2022-10-31T07:23:08\"\n }\n ]\n}"},{"id":"54ed74e0-da2a-402e-a6aa-d73aa351e519","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"key":"customerId","value":"velit tempor","type":"text"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/job?limit=5&offset=0&sort=-createdDate","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["job"],"query":[{"key":"limit","value":"5"},{"key":"offset","value":"0"},{"key":"sort","value":"-createdDate"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"1ade3e9e-af2f-4450-b914-3a3088d6f0db"}],"id":"a99a8865-4e85-448f-8a15-5f572e939685","_postman_id":"a99a8865-4e85-448f-8a15-5f572e939685","description":"","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"ODMatrix","item":[{"name":"post OD Matrix","id":"c7013e58-60b0-4c72-943e-e1f10bb22b7d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"POST","header":[{"description":"

(Required) CustomerId is required

An OD Matrix is an area of study between two or more areas as defined by the study areas. \nIt will provide the number of devices that travelled between the Matrix defined based upon the study zones and parameters provided in the job for the corresponding Job ID

Example:\nHow many devices travelled between Toronto and Kingston (and vice versa) between Mon 20th April - Fri 24th April between 6am and 8pm.

\n","urlObject":{"path":["count","odmatrix"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"b7647ca5-480d-4523-b629-76ea9670804f","name":"Job created for request","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"estimation_only\": false,\n \"time_bucket_size\": 30,\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/odmatrix"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"amet Excepteur enim\",\n \"link\": {\n \"rel\": \"aliquip est\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"token_usage\": 8599126.522849992\n}"},{"id":"3367ec00-25db-425e-86b5-0d020305b41f","name":"Invalid Input","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"estimation_only\": false,\n \"time_bucket_size\": 30,\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/odmatrix"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"e1c12073-57e6-4aef-b4aa-769f1ab4228a","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"estimation_only\": false,\n \"time_bucket_size\": 30,\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/odmatrix"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"c7013e58-60b0-4c72-943e-e1f10bb22b7d"},{"name":"get OD Matrix","id":"10658b3f-1651-4f4f-9da9-11067ecbe2c8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Accept","value":"application/json"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/odmatrix/:jobId","description":"","urlObject":{"path":["count","odmatrix",":jobId"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"a7b9306d-480a-48ec-909f-dd5be8b2f5b2","description":{"content":"

(Required) The request id returned from POST request

\n","type":"text/plain"},"type":"any","value":"velit tempor","key":"jobId"}]}},"response":[{"id":"67003eec-dced-4c64-a4d9-7b611dbe0f96","name":"response","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/odmatrix/:jobId","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","count","odmatrix",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zones\": [\n {\n \"input_geoid\": \"Kelowna\",\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"outputs\": [\n {\n \"count\": 90,\n \"output_geoid\": \"Toronto\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 70,\n \"output_geoid\": \"Kelowna\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"outputs\": [\n {\n \"count\": 120,\n \"output_geoid\": \"Toronto\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 80,\n \"output_geoid\": \"Kelowna\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n }\n ]\n },\n {\n \"input_geoid\": \"Toronto\",\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"outputs\": [\n {\n \"count\": 60,\n \"output_geoid\": \"Kelowna\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 90,\n \"output_geoid\": \"Toronto\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"outputs\": [\n {\n \"count\": 110,\n \"output_geoid\": \"Kelowna\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 60,\n \"output_geoid\": \"Toronto\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n }\n ]\n }\n ]\n}"},{"id":"02bddb68-600d-4961-b667-98ec7247d65f","name":"Request was accepted and being processed on.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/odmatrix/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","odmatrix",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"voluptate deserunt\",\n \"link\": {\n \"rel\": \"self\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"status\": \"Processing\"\n}"},{"id":"0cbf8ab3-757f-4be1-b189-bb28aa106877","name":"Invalid Input","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/odmatrix/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","odmatrix",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"e6eef702-80d2-4856-b52a-0f1f4cb7a56e","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/odmatrix/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","odmatrix",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"8d8a27f8-a74b-408c-a48e-9c7cfa993398","name":"Resource not found","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/odmatrix/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","odmatrix",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404,\n \"message\": \"Method does not exist.\"\n}"}],"_postman_id":"10658b3f-1651-4f4f-9da9-11067ecbe2c8"}],"id":"d9b531ea-822a-4f94-8c73-fee1ea42b14c","description":"

Get the OD Matrix with the count of trips going from each origin to each destination

\n","_postman_id":"d9b531ea-822a-4f94-8c73-fee1ea42b14c","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"Origin","item":[{"name":"post Origin","id":"1ed5c6ef-f4d1-4422-a136-a91a6a1d8db7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"POST","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ],\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n },\n \"pass_through_geoid\": {\n \"requestId\": \"a7643453703b-23443-4834f-8359-8c50f1a\",\n \"study_zone\": [\n \"Seven Oaks\"\n ],\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n },\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ],\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n },\n \"timezone\": \"UTC\",\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"time_bucket_size\": 30,\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/origin","description":"

Provides the number of devices with trips originating at each output study zone for the given parameters defined by the job, which corresponds to the job ID.

Example: How many devices came from Port Credit, and Brampton and travelled to Rogers Centre in downtown Toronto on 1st December 2019, between 9am - 1pm.

\n","urlObject":{"path":["count","origin"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"5e615554-6852-4534-a3ee-9484ac4fc036","name":"Job created for request","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/origin"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"amet Excepteur enim\",\n \"link\": {\n \"rel\": \"aliquip est\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"token_usage\": 8599126.522849992\n}"},{"id":"c0585050-705a-4c5f-aeab-aa723eb7e8cf","name":"Invalid Input","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/origin"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"fdef0a78-c9fc-4cf9-a606-b83ba06d86c9","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/origin"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"1ed5c6ef-f4d1-4422-a136-a91a6a1d8db7"},{"name":"get Origin","id":"81cd206e-e01b-4e7b-8925-333d329dfc09","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Accept","value":"application/json"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/origin/:jobId","description":"","urlObject":{"path":["count","origin",":jobId"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"539dd686-e104-4eb2-99aa-9a7498eace70","description":{"content":"

(Required) The request id returned from POST request

\n","type":"text/plain"},"type":"any","value":"velit tempor","key":"jobId"}]}},"response":[{"id":"13b537dd-7d49-473f-a377-04961f3c4921","name":"response","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/origin/:jobId","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","count","origin",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zones\": [\n {\n \"input_geoid\": \"Kelowna\",\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"outputs\": [\n {\n \"count\": 90,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 70,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"outputs\": [\n {\n \"count\": 120,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 80,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c5\"\n }\n ]\n }\n ]\n },\n {\n \"input_geoid\": \"Toronto\",\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"outputs\": [\n {\n \"count\": 60,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 90,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"outputs\": [\n {\n \"count\": 110,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 60,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n }\n ]\n }\n ]\n}"},{"id":"e2d40b6b-793b-4344-b9f5-e9a166562269","name":"Request was accepted and being processed on.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/origin/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","origin",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"voluptate deserunt\",\n \"link\": {\n \"rel\": \"self\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"status\": \"Processing\"\n}"},{"id":"e603eaec-644e-452b-bdaa-d0a0f08eeaad","name":"Invalid Input","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/origin/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","origin",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"30c72eaa-b626-4683-9e19-918c3040d5dc","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/origin/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","origin",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"0691486f-920e-490c-bcef-fbbe0a41e0d0","name":"Resource not found","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/origin/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","origin",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404,\n \"message\": \"Method does not exist.\"\n}"}],"_postman_id":"81cd206e-e01b-4e7b-8925-333d329dfc09"}],"id":"32b08a9f-6ca3-4862-b4f3-49204b427782","description":"

Get the list of areas, with a count that the users in the area dwelled at previous to the current location

\n","_postman_id":"32b08a9f-6ca3-4862-b4f3-49204b427782","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"Read Area","item":[{"name":"List Shapefiles","id":"e05984ba-917a-4c7a-92cb-fff5e0e628f2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{},"isInherited":false},"method":"GET","header":[{"key":"customerId","value":"velit tempor","type":"text"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile?selectfiles=user","description":"

This endpoint returns the list of shapefiles based on the following query parameters.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Passed in	Description	Example
selectfiles (optional)	query	The selectfiles value defines the list of shapefiles to be returned i.e. shapefiles uploaded by the user, shapefiles belonging to the organization, public shapefiles or all the shapefiles available to the user. Allowed values: user, organization, public, all.	selectfiles=public

","urlObject":{"path":["shapefile"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[{"description":{"content":"

Valid values: user, organization, public, all

\n","type":"text/plain"},"key":"selectfiles","value":"user"}],"variable":[]}},"response":[{"id":"3891000a-5390-48c3-a3bb-8cae7bd2c0b1","name":"Success - list of user shapefiles","originalRequest":{"method":"GET","header":[{"key":"customerId","value":"velit tempor","type":"text"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile?selectfiles=user","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","shapefile"],"query":[{"key":"selectfiles","value":"user"}]}},"status":"Partial Content","code":206,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"orginalFilename\": \"winnepeg.zip\",\n \"status\": \"COMPLETE\",\n \"requestId\": \"winnepeg-zip-2aaaee62-bc47-4cb9-a388-1d88aa5386fc\",\n \"totalZones\": 1,\n \"studyZones\": [\n \"zone 1\"\n ],\n \"createdDate\": \"2022-09-20T23:14:21\",\n \"shapeFileType\": \"user\"\n }\n]"},{"id":"abd9aa7b-4ac4-4690-b44c-904476963f19","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"key":"customerId","value":"velit tempor","type":"text"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile?selectfiles=user","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["shapefile"],"query":[{"key":"selectfiles","value":"user"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"e05984ba-917a-4c7a-92cb-fff5e0e628f2"},{"name":"Retrieve status of the shapefile upload","id":"b10ad9bf-e584-4cd7-9080-437e8dae8a11","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

By passing in the request ID, you can determine the status of the shapefile

\n","urlObject":{"path":["shapefile",":requestId"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"22f52008-8cd4-4f0d-82fd-28a0c785d058","description":{"content":"

(Required) Request ID generated from POST /upload

\n","type":"text/plain"},"type":"any","value":"0cb536bc-f362-938d-5e01-ed243b27fe7e","key":"requestId"}]}},"response":[{"id":"037806f6-465d-467b-9b59-e172f82cc4e0","name":"Success, results processed","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile/:requestId","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","shapefile",":requestId"],"variable":[{"key":"requestId","value":"0cb536bc-f362-938d-5e01-ed243b27fe7e","description":"(Required) Request ID generated from POST /upload"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"link\": [\n {\n \"method\": \"POST\",\n \"rel\": \"geofence\",\n \"url\": \"/geofence\"\n },\n {\n \"method\": \"POST\",\n \"rel\": \"geofence\",\n \"url\": \"/geofence\"\n }\n ],\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"status\": \"PROCESSED\"\n}"},{"id":"e6f20cf9-d0c0-4583-a694-cda912b8d0b5","name":"Processing","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile/:requestId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["shapefile",":requestId"],"variable":[{"key":"requestId","value":"0cb536bc-f362-938d-5e01-ed243b27fe7e","description":"(Required) Request ID generated from POST /upload"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"description\": \"Your results are still processing and being validated\",\n \"link\": {\n \"rel\": \"status\",\n \"url\": \"/status\"\n },\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"status\": \"INPROCESS\"\n}"},{"id":"465a2432-6d23-441c-b1c0-e272c3eeb63f","name":"Invalid Input","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile/:requestId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["shapefile",":requestId"],"variable":[{"key":"requestId","value":"0cb536bc-f362-938d-5e01-ed243b27fe7e","description":"(Required) Request ID generated from POST /upload"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"00591ad7-862d-42e4-a6a4-68ce4e9b4ce1","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile/:requestId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["shapefile",":requestId"],"variable":[{"key":"requestId","value":"0cb536bc-f362-938d-5e01-ed243b27fe7e","description":"(Required) Request ID generated from POST /upload"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"ff866fa0-f5fd-4367-bb83-ebddcffa2d61","name":"Invalid shapefile. Please validate and upload the shapefile again. Make sure the boundaries are well defined. This error happens if the GIS technician finds out the shapefile in invalid. Therefore the request Id is avaliable.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile/:requestId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["shapefile",":requestId"],"variable":[{"key":"requestId","value":"0cb536bc-f362-938d-5e01-ed243b27fe7e","description":"(Required) Request ID generated from POST /upload"}]}},"status":"Precondition Failed","code":412,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"description\": \"Invalid Shapefile\",\n \"requestId\": \"d764703b-2143-48ff-8929-d18bc50f1a62\"\n}"}],"_postman_id":"b10ad9bf-e584-4cd7-9080-437e8dae8a11"}],"id":"689b7cd9-ee9d-4bdf-9b0c-dc42a014a745","description":"

Used to read shapefiles

\n","_postman_id":"689b7cd9-ee9d-4bdf-9b0c-dc42a014a745","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"RepeatVisitation","item":[{"name":"post Repeat Visitation","id":"0f67554c-9d8a-4095-b4ee-1d0f0daeddd6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"POST","header":[{"description":"

(Required) CustomerId is required

The number of unique devices that have been in the given area more than once based on the parameters provided in the job for the corresponding Job ID.

Example: How many devices went to Stanley Park more than once in the month of July 2020?

\n","urlObject":{"path":["count","repeatvisitation"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"622f288f-b1f9-4ba5-9729-a36f722e9205","name":"Job created for request","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/repeatvisitation"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"amet Excepteur enim\",\n \"link\": {\n \"rel\": \"aliquip est\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"token_usage\": 8599126.522849992\n}"},{"id":"3cd07bf8-c466-4e03-bb06-99438b0f0e4d","name":"Invalid Input","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/repeatvisitation"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"a0866ed4-46f9-4e49-b2d5-fc6f922afec6","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/repeatvisitation"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"0f67554c-9d8a-4095-b4ee-1d0f0daeddd6"},{"name":"get Repeat Visitation","id":"2c6e9d07-be42-42ba-b435-0f7c27f8f253","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Accept","value":"application/json"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/repeatvisitation/:jobId","description":"","urlObject":{"path":["count","repeatvisitation",":jobId"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"c5513194-a551-41f2-8077-ca8fc7662d72","description":{"content":"

(Required) The request id returned from POST request

\n","type":"text/plain"},"type":"any","value":"velit tempor","key":"jobId"}]}},"response":[{"id":"f515c5fa-df4b-4a3e-810b-eb9d87f02e9f","name":"response","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/repeatvisitation/:jobId","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","count","repeatvisitation",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"time_bucket_size\": 30,\n \"end_time\": \"2020-01-03T01:00:00\",\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"start_time\": \"2020-01-03T00:00:00\",\n \"study_zones\": [\n {\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"count\": 90\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"count\": 120\n }\n ],\n \"input_geoid\": \"Kelowna\"\n },\n {\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"count\": 70\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"count\": 80\n }\n ],\n \"input_geoid\": \"Calgary\"\n }\n ]\n}"},{"id":"9fd82f12-077d-4c8f-80c1-ae6932262501","name":"Request was accepted and being processed on.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/repeatvisitation/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","repeatvisitation",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"voluptate deserunt\",\n \"link\": {\n \"rel\": \"self\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"status\": \"Processing\"\n}"},{"id":"6f2ab942-907e-4b8d-8810-45aab893abc8","name":"Invalid Input","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/repeatvisitation/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","repeatvisitation",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"2e0b31f2-754e-45c2-a0a2-159006bfd6be","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/repeatvisitation/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","repeatvisitation",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"56fcd73a-b1cf-4952-86f6-35338943b5d1","name":"Resource not found","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/repeatvisitation/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","repeatvisitation",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404,\n \"message\": \"Method does not exist.\"\n}"}],"_postman_id":"2c6e9d07-be42-42ba-b435-0f7c27f8f253"}],"id":"5bbcb1d5-7b3d-4702-918b-183772e8ffcb","description":"

Get the the count of repeat visitors in an area during the given timeframe_bucket in the given geography during the given time.

\n","_postman_id":"5bbcb1d5-7b3d-4702-918b-183772e8ffcb","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"Shapefile Delete","item":[{"name":"Endpoint for deleting a Shapefile","id":"bfd5d873-d884-43bf-9137-995bab1a2a63","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{},"isInherited":false},"method":"DELETE","header":[{"key":"customerId","value":"velit tempor"},{"key":"Accept","value":"application/json"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile/:requestId","urlObject":{"path":["shapefile",":requestId"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"fd10e888-f83b-4e03-807e-5712081a7c82","type":"any","value":null,"key":"requestId"}]}},"response":[{"id":"730d6be2-f03b-41c5-8718-6583262344de","name":"response","originalRequest":{"method":"DELETE","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile/:requestId","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","shapefile",":requestId"],"variable":[{"key":"requestId"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -46570025,\n \"requestId\": \"enim reprehenderit\",\n \"message\": \"nulla\"\n}"},{"id":"c6ff35d6-d149-49cd-9c8c-6333550eea74","name":"response","originalRequest":{"method":"DELETE","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile/:requestId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["shapefile",":requestId"],"variable":[{"key":"requestId"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": -53634451,\n \"message\": \"est dolore\"\n}"},{"id":"5decc403-4df8-41cb-ad24-be9e3b0ece23","name":"response","originalRequest":{"method":"DELETE","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/shapefile/:requestId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["shapefile",":requestId"],"variable":[{"key":"requestId"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"esse ut\"\n}"}],"_postman_id":"bfd5d873-d884-43bf-9137-995bab1a2a63"}],"id":"582d202e-d04d-4829-8455-fc2aee59cbac","_postman_id":"582d202e-d04d-4829-8455-fc2aee59cbac","description":"","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"TotalTrip","item":[{"name":"post Total Trip","id":"eadb82df-945d-4226-af51-58efb48d9ee1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"POST","header":[{"description":"

(Required) CustomerId is required

The total number of trips made by devices over a given period of time as specified by the input parameters.

Example: How many devices took more than 10 trips to Toronto in the month of May, 2020?

\n","urlObject":{"path":["count","totaltrip"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"11f2dd46-4d91-41a8-8a83-fbc5236fa2c4","name":"Job created for request","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/totaltrip"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"amet Excepteur enim\",\n \"link\": {\n \"rel\": \"aliquip est\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"token_usage\": 8599126.522849992\n}"},{"id":"2a195d80-de94-4e00-af0d-0730bb60f249","name":"Invalid Input","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/totaltrip"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"2cb5984a-ce59-446c-820e-336d8a585713","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/totaltrip"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"eadb82df-945d-4226-af51-58efb48d9ee1"},{"name":"get Total Trip","id":"53239d7b-129e-4bb8-b63d-f294fc30896c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Accept","value":"application/json"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/totaltrip/:jobId","description":"","urlObject":{"path":["count","totaltrip",":jobId"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"39261632-8469-4daa-a6de-cd986873c6ca","description":{"content":"

(Required) The request id returned from POST request

\n","type":"text/plain"},"type":"any","value":"velit tempor","key":"jobId"}]}},"response":[{"id":"d100610a-6090-408b-9182-7217f62c598a","name":"response","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/totaltrip/:jobId","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","count","totaltrip",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"time_bucket_size\": 30,\n \"end_time\": \"2020-01-03T01:00:00\",\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"start_time\": \"2020-01-03T00:00:00\",\n \"study_zones\": [\n {\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"count\": 90\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"count\": 120\n }\n ],\n \"input_geoid\": \"Kelowna\"\n },\n {\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"count\": 70\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"count\": 80\n }\n ],\n \"input_geoid\": \"Calgary\"\n }\n ]\n}"},{"id":"633b3112-f2e6-4fd7-8685-c610ae3508c2","name":"Request was accepted and being processed on.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/totaltrip/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","totaltrip",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"voluptate deserunt\",\n \"link\": {\n \"rel\": \"self\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"status\": \"Processing\"\n}"},{"id":"d31509db-60cf-442f-a699-c86fe509c8a6","name":"Invalid Input","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/totaltrip/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","totaltrip",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"fe0a57d0-89a1-4da4-803b-f0f9f09b5117","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/totaltrip/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","totaltrip",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"c1faebbb-133d-4493-8f42-66f56c01e4f6","name":"Resource not found","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/totaltrip/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","totaltrip",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404,\n \"message\": \"Method does not exist.\"\n}"}],"_postman_id":"53239d7b-129e-4bb8-b63d-f294fc30896c"}],"id":"ed4a9c44-9daa-4564-9cad-f92dce2a32cb","description":"

Get count of total trips across a zone

\n","_postman_id":"ed4a9c44-9daa-4564-9cad-f92dce2a32cb","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"TradeArea","item":[{"name":"post Trade Area","id":"2356aee8-9d29-485a-a9a6-bdfb7196d02a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"POST","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"timezone\": \"UTC\",\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ]\n },\n \"primary_threshold\": 0.3,\n \"secondary_threshold\": 0.4,\n \"count_weight\": 0.4,\n \"trip_weight\": 0.4,\n \"distance_weight\": 0.4,\n \"estimation_only\": true,\n \"time_bucket_size\": 30,\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/tradearea","description":"

For each Study Zone in the Output GeoID, a list of its classification (Primary / Secondary / Tertiary) for the trade area of the input GeoID based on the parameters in the job for the corresponding Job ID

Example: Return primary secondary and tertiary trade areas

\n","urlObject":{"path":["count","tradearea"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"4c53f610-178b-414b-895d-6ae0fd47e7dc","name":"Job created for request","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ]\n },\n \"primary_threshold\": 0.3,\n \"secondary_threshold\": 0.4,\n \"count_weight\": 0.4,\n \"trip_weight\": 0.4,\n \"distance_weight\": 0.4,\n \"estimation_only\": true,\n \"time_bucket_size\": 30,\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/tradearea"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"amet Excepteur enim\",\n \"link\": {\n \"rel\": \"aliquip est\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"token_usage\": 8599126.522849992\n}"},{"id":"6d52662a-f50f-4c04-9abc-cba38d4f8d15","name":"Invalid Input","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ]\n },\n \"primary_threshold\": 0.3,\n \"secondary_threshold\": 0.4,\n \"count_weight\": 0.4,\n \"trip_weight\": 0.4,\n \"distance_weight\": 0.4,\n \"estimation_only\": true,\n \"time_bucket_size\": 30,\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/tradearea"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"fe1f9b1d-3355-4c88-954f-ef46bfb098a9","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ]\n },\n \"primary_threshold\": 0.3,\n \"secondary_threshold\": 0.4,\n \"count_weight\": 0.4,\n \"trip_weight\": 0.4,\n \"distance_weight\": 0.4,\n \"estimation_only\": true,\n \"time_bucket_size\": 30,\n \"min_dwell_time\": 15,\n \"max_dwell_time\": 30\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/tradearea"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"2356aee8-9d29-485a-a9a6-bdfb7196d02a"},{"name":"get Trade Area","id":"a2484ea5-694b-4eb3-b8b9-9b89af84a275","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Accept","value":"application/json"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/tradearea/:jobId","description":"","urlObject":{"path":["count","tradearea",":jobId"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"b93a4f4b-16ff-4b35-a3b5-e86afb36ba2f","description":{"content":"

(Required) The request id returned from POST request

\n","type":"text/plain"},"type":"any","value":"velit tempor","key":"jobId"}]}},"response":[{"id":"ac2d7c8b-84d2-403d-84b1-3d5f4360d957","name":"response","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/tradearea/:jobId","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","count","tradearea",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zones\": [\n {\n \"input_geoid\": \"Kelowna\",\n \"outputs\": [\n {\n \"category\": \"Primary\",\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"category\": \"Secondary\",\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n },\n {\n \"input_geoid\": \"Toronto\",\n \"outputs\": [\n {\n \"category\": \"Primary\",\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"category\": \"Secondary\",\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n }\n ]\n}"},{"id":"e583d397-6124-4da1-85d7-de5d292628f1","name":"Request was accepted and being processed on.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/tradearea/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","tradearea",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"voluptate deserunt\",\n \"link\": {\n \"rel\": \"self\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"status\": \"Processing\"\n}"},{"id":"9d98502a-034d-4b51-9a6b-5061e0baac47","name":"Invalid Input","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/tradearea/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","tradearea",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"2e8f5466-924a-4ada-bd32-9cc951ae1fc6","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/tradearea/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","tradearea",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"91b443c0-2489-43dd-a19f-ca19651cc3fd","name":"Resource not found","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/tradearea/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","tradearea",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404,\n \"message\": \"Method does not exist.\"\n}"}],"_postman_id":"a2484ea5-694b-4eb3-b8b9-9b89af84a275"}],"id":"1680bbb9-b19b-4725-8af9-87af59c0d9cc","description":"

Return the list of output areas, labeled with primary secondary and tertiary trade areas

\n","_postman_id":"1680bbb9-b19b-4725-8af9-87af59c0d9cc","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"Unique","item":[{"name":"post Unique","id":"2a90821b-9a79-4afe-aec5-69be9f0d2761","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) CustomerId is required

Provides the number of unique devices for the given parameters defined by the job, which corresponds to the job ID.

Example: How many unique devices visited downtown Squamish on Saturday 14th November 2020, broken down by hour of day.

\n","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}},"urlObject":{"path":["count","unique"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"223836f2-1ce8-4120-9ad2-4a900bb641b6","name":"Job created for request","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/unique"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"amet Excepteur enim\",\n \"link\": {\n \"rel\": \"aliquip est\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"token_usage\": 8599126.522849992\n}"},{"id":"8bee2650-4b69-4882-8a2c-2ede94e3257e","name":"Invalid Input","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/unique"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"7baf27d1-49c2-4955-9df2-588aea43d0f6","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/unique"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"9ca5c70b-9413-49b9-9960-7dfaec77be9a","name":"Resource not found","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/unique"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404,\n \"message\": \"Method does not exist.\"\n}"}],"_postman_id":"2a90821b-9a79-4afe-aec5-69be9f0d2761"},{"name":"get Unique","id":"cc2146fe-89af-4520-a980-1f8c2ae12bed","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Accept","value":"application/json"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/unique/:jobId","description":"","urlObject":{"path":["count","unique",":jobId"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"d2c31972-b41a-435d-a5b2-da1227114d43","description":{"content":"

(Required) The request id returned from POST request

\n","type":"text/plain"},"type":"any","value":"velit tempor","key":"jobId"}]}},"response":[{"id":"3c0f5168-7075-48fc-8fbf-77cbe2c5174e","name":"response","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/unique/:jobId","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","count","unique",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"time_bucket_size\": 30,\n \"end_time\": \"2020-01-03T01:00:00\",\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"start_time\": \"2020-01-03T00:00:00\",\n \"study_zones\": [\n {\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"count\": 90\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"count\": 120\n }\n ],\n \"input_geoid\": \"Kelowna\"\n },\n {\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"count\": 70\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"count\": 80\n }\n ],\n \"input_geoid\": \"Calgary\"\n }\n ]\n}"},{"id":"cc78dcbf-aa57-410f-8d80-f02c8cb7712d","name":"Request was accepted and being processed on.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/unique/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","unique",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"voluptate deserunt\",\n \"link\": {\n \"rel\": \"self\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"status\": \"Processing\"\n}"},{"id":"2faddee6-3786-4d64-98da-964d7ff088fd","name":"Invalid Input","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/unique/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","unique",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"bc6f8df4-47fa-4ea7-94fb-85556975c0e1","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/unique/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","unique",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"44e27056-e417-45c2-bd10-3cf64f3873a7","name":"Resource not found","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/unique/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","unique",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404,\n \"message\": \"Method does not exist.\"\n}"}],"_postman_id":"cc2146fe-89af-4520-a980-1f8c2ae12bed"}],"id":"bd28fabe-ea2d-48aa-9e1d-14d8c4906763","description":"

Get count of Unique users in an area

\n","_postman_id":"bd28fabe-ea2d-48aa-9e1d-14d8c4906763","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"Usage","item":[{"name":"get Usage","id":"682fa97d-51af-4afb-9f2c-bd518464f7c8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Accept","value":"application/json"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/usage","description":"

Returns the number of calls submitted by the user's organization broken down by year, month and endpoint. It also returns the count of distinct study zones queried every month.

The API usage is updated every hour.

\n","urlObject":{"path":["usage"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"fbe01cb1-bc26-4f4f-bd9c-f38470ec741d","name":"Success","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/usage"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"2021\": {\n \"monthly_breakdown\": {\n \"1\": {\n \"studyzone\": {\n \"total\": 15\n },\n \"api\": {\n \"total\": 20,\n \"breakdown\": [\n [\n {\n \"api\": \"home\",\n \"count\": 5\n },\n {\n \"api\": \"dwelltime\",\n \"count\": 15\n }\n ]\n ]\n }\n }\n }\n }\n}"},{"id":"c8ceba34-e2c4-4c68-b207-45e9984fc60f","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/usage"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"b361941a-1fb6-45f3-8d40-c42419acf0ce","name":"Resource not found","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/usage"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404,\n \"message\": \"Method does not exist.\"\n}"}],"_postman_id":"682fa97d-51af-4afb-9f2c-bd518464f7c8"}],"id":"2fc68313-36f6-483a-b934-cd964446cd75","description":"

Provides the API usage of the organization.

\n","_postman_id":"2fc68313-36f6-483a-b934-cd964446cd75","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}},{"name":"Work","item":[{"name":"post Work","id":"afeeb26c-3b23-49bd-af88-d613e1bba9d0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"timezone\": \"UTC\",\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ]\n },\n \"estimation_only\": true,\n \"time_bucket_size\": 30,\n \"max_dwell_time\": 30,\n \"min_dwell_time\": 15\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/work","description":"

The assumed work neighbourhoods of devices for the parameters given by the job corresponding to the Job ID. Each home neighbourhood is represented by the provided Output GeoID

Example: How many devices work within the “Mississauga retail park” between Mississauga and Derry Road that travel from Burlington in the month of January.

\n","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}},"urlObject":{"path":["count","work"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[]}},"response":[{"id":"22cd738f-01d7-4ac1-be91-9b1b4a5f27df","name":"Job created for request","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ]\n },\n \"estimation_only\": false,\n \"time_bucket_size\": 30,\n \"max_dwell_time\": 30,\n \"min_dwell_time\": 15\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/work"},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"amet Excepteur enim\",\n \"link\": {\n \"rel\": \"aliquip est\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"token_usage\": 8599126.522849992\n}"},{"id":"c55bc3fd-5197-419b-b198-241c0f42fffb","name":"Invalid Input","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ]\n },\n \"estimation_only\": false,\n \"time_bucket_size\": 30,\n \"max_dwell_time\": 30,\n \"min_dwell_time\": 15\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/work"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"5cf47f9b-a874-4388-a1b7-62a6b7f5576e","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"body":{"mode":"raw","raw":"{\n \"input_geoid\": {\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"study_zone\": [\n \"Kelowna\",\n \"Toronto\"\n ]\n },\n \"start_time\": \"2020-01-03T00:00:00\",\n \"end_time\": \"2020-01-03T01:00:00\",\n \"output_geoid\": {\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\",\n \"study_zone\": [\n \"Calgary\",\n \"Niagara\"\n ]\n },\n \"estimation_only\": false,\n \"time_bucket_size\": 30,\n \"max_dwell_time\": 30,\n \"min_dwell_time\": 15\n}","options":{"raw":{"language":"json"}}},"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/work"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"}],"_postman_id":"afeeb26c-3b23-49bd-af88-d613e1bba9d0"},{"name":"get Work","id":"44a4a61d-61ec-4e4c-b9c2-1ec075a044e1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"scope":"{{AuthCodeScopeIds}}","clientSecret":"{{AuthCodeClientSecret}}","clientId":"{{AuthCodeClientId}}","accessTokenUrl":"{{AccessTokenURL}}","grant_type":""},"isInherited":false},"method":"GET","header":[{"description":"

(Required) CustomerId is required

\n","key":"customerId","value":"velit tempor"},{"key":"Accept","value":"application/json"}],"url":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/work/:jobId","description":"","urlObject":{"path":["count","work",":jobId"],"host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"query":[],"variable":[{"id":"0ed225cc-16cd-419d-88b4-6a9e5ba70bbc","description":{"content":"

(Required) The request id returned from POST request

\n","type":"text/plain"},"type":"any","value":"velit tempor","key":"jobId"}]}},"response":[{"id":"16c71640-fa73-422a-9c6d-17e6d7666e5a","name":"response","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/work/:jobId","protocol":"https","host":["location-api","insights","telus","com"],"path":["product","insightsRequest","v1","count","work",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"time_bucket_size\": 30,\n \"end_time\": \"2020-01-03T01:00:00\",\n \"requestId\": \"c764703b-2043-48ff-8929-d18bc50f1a62\",\n \"start_time\": \"2020-01-03T00:00:00\",\n \"study_zones\": [\n {\n \"input_geoid\": \"Kelowna\",\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"outputs\": [\n {\n \"count\": 90,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 70,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"outputs\": [\n {\n \"count\": 120,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 80,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n }\n ]\n },\n {\n \"input_geoid\": \"Toronto\",\n \"buckets\": [\n {\n \"timeframe_bucket\": \"2020-01-03T00:00:00\",\n \"outputs\": [\n {\n \"count\": 60,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 90,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n },\n {\n \"timeframe_bucket\": \"2020-01-03T00:30:00\",\n \"outputs\": [\n {\n \"count\": 110,\n \"output_geoid\": \"Calgary\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n },\n {\n \"count\": 60,\n \"output_geoid\": \"Niagara\",\n \"requestId\": \"bd8b10da-8318-4fc1-baed-5823e14b2c52\"\n }\n ]\n }\n ]\n }\n ]\n}"},{"id":"20281054-5bfc-44cd-b029-69dbc3cb498c","name":"Request was accepted and being processed on.","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/work/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","work",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Accepted","code":202,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"jobId\": \"voluptate deserunt\",\n \"link\": {\n \"rel\": \"self\",\n \"url\": \"/{self}/{jobId}\"\n },\n \"status\": \"Processing\"\n}"},{"id":"6122c706-85eb-4277-8c88-e8bb8455b9e1","name":"Invalid Input","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/work/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","work",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Invalid input\"\n}"},{"id":"b1e43fa2-43db-4aca-9204-9c89c91afa1f","name":"Unauthorized","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/work/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","work",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 401,\n \"message\": \"Unauthorized\"\n}"},{"id":"c6e6ea6a-9a95-47bf-8713-3aa321acdcbb","name":"Resource not found","originalRequest":{"method":"GET","header":[{"description":"Added as a part of security scheme: oauth2","key":"Authorization","value":""},{"description":"(Required) CustomerId is required","key":"customerId","value":"velit tempor"}],"url":{"raw":"https://location-api.insights.telus.com/product/insightsRequest/v1/count/work/:jobId","host":["https://location-api.insights.telus.com/product/insightsRequest/v1"],"path":["count","work",":jobId"],"variable":[{"key":"jobId","value":"velit tempor","description":"(Required) The request id returned from POST request"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404,\n \"message\": \"Method does not exist.\"\n}"}],"_postman_id":"44a4a61d-61ec-4e4c-b9c2-1ec075a044e1"}],"id":"70bbf94e-8b4c-4963-ab11-14f0474461db","description":"

Get count of people in Current(Input) location who have Work area in provided(Output) location

\n","_postman_id":"70bbf94e-8b4c-4963-ab11-14f0474461db","auth":{"type":"oauth2","oauth2":{},"isInherited":true,"source":{"_postman_id":"d8e042de-3754-42b6-beb6-a174697eddf8","id":"d8e042de-3754-42b6-beb6-a174697eddf8","name":"Telus Insights Location API","type":"collection"}}}],"auth":{"type":"oauth2","oauth2":{}},"variable":[{"id":"6e19bde9-97bb-4b25-ba23-c69b1043d6c1","key":"baseUrl","value":"https://location-api.insights.telus.com/product/insightsRequest/v1","type":"string"}]}