{"id":25172,"date":"2016-05-06T15:39:15","date_gmt":"2016-05-06T14:39:15","guid":{"rendered":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/?page_id=25172"},"modified":"2020-12-01T22:49:22","modified_gmt":"2020-12-01T22:49:22","slug":"including-parameters-in-an-instantatlas-report-url","status":"publish","type":"page","link":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/en\/welcome\/support-articles\/including-parameters-in-an-instantatlas-report-url\/","title":{"rendered":"Including Parameters in an InstantAtlas Report URL"},"content":{"rendered":"<h2>Introduction<\/h2>\n<p>You can include parameters in the URL for an InstantAtlas report to trigger various events. For each event, the syntax you should use in the URL is described in the sections below.<\/p>\n<h2>Open the Report with a Particular Indicator and Time Period Selected<\/h2>\n<p>Syntax:<\/p>\n<p>[URL to report]?indicator=[indicator ID]&amp;date=[date]<\/p>\n<p>For example:<\/p>\n<p><a href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?indicator=i1&amp;date=2003\" target=\"_blank\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?indicator=i1&amp;date=2003<\/a><\/p>\n<p>If the indicator you wish to open does not have time periods, you can leave the \u2018&amp;date=[date]\u2019 out of the URL.<\/p>\n<p>For example:<\/p>\n<p><a href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?indicator=i7\" target=\"_blank\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?indicator=i7<\/a><\/p>\n<p>For the double map and double map time series a specific indicator and time period can be passed to each of the two maps<\/p>\n<p>Syntax:<\/p>\n<p>[URL to report]?indicator=[indicator ID]&amp;date=[date]&amp;indicator2=[indicator ID]&amp;date2=[date]<\/p>\n<p>For example:<\/p>\n<p><a href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/dm\/atlas.html?indicator=i9&amp;indicator2=i1&amp;date2=2003\" target=\"_blank\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/dm\/atlas.html?indicator=i9&amp;indicator2=i1&amp;date2=2003<\/a><\/p>\n<h2>Open the Report with a Particular Base Geography Selected<\/h2>\n<p>Syntax:<\/p>\n<p>[URL to report]?geog=[position of the base geography in the data.js file starting with 0]<\/p>\n<p>For example:<\/p>\n<p><a target=\"_blank\" href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?geog=1\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?geog=1<\/a><\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2015\/08\/image7.png\" alt=\"image7\" class=\"alignnone size-full wp-image-7021\" width=\"22\" height=\"20\" \/> Note that some templates require more then one parameter to work correctly. This depends on the number of data explorers in your report. You will require a parameter for each of these explorers, e.g. two for the Double Map (data explorer map 1 and 2) and four for a Bubble Plot report (data explorer, x-axis, y-axis, color). In case of a Bubble Plot the correct URL would e.g. look something like this:<\/p>\n<p>[URL to report]?geog=2&amp;geog2=2&amp;geog3=2&amp;geog4=2<\/p>\n<h2>Open the Report with a Geographic Feature Selected<\/h2>\n<p>Syntax:<\/p>\n<p>[URL to report]?select=[feature ID]<\/p>\n<p>For example:<\/p>\n<p><a target=\"_blank\" href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?select=22007\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?select=22007<\/a><\/p>\n<p>You can have more than one geographic feature selected when loading the report by using a comma delimited list.<\/p>\n<p>Syntax:<\/p>\n<p>[URL to report]?select=[feature ID1], [feature ID2], [feature ID3] &#8230;.<\/p>\n<p>For example:<\/p>\n<p><a target=\"_blank\" href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?select=22007,22089,22103\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?select=22007,22089,22103<\/a><\/p>\n<p>A double map time series report allows you to select different geographies in both maps.<\/p>\n<p>Syntax:<\/p>\n<p>[URL to report]?select=[feature ID]&amp;select2=[feature ID]<\/p>\n<p>For example:<\/p>\n<p><a target=\"_blank\" href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/dmts\/atlas.html?select=22109&amp;select2=15\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/dmts\/atlas.html?select=22109&amp;select2=15<\/a><\/p>\n<h2>Open the Report with a Comparison Feature Selected<\/h2>\n<p>Syntax:<\/p>\n<p>[URL to report]?comparisonSelect=[feature ID]<\/p>\n<p>For example:<\/p>\n<p><a target=\"_blank\" href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?comparisonSelect=15\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?comparisonSelect=15<\/a><\/p>\n<p>You can have more than one geographic feature selected when loading the report by using a comma delimited list.<\/p>\n<p>Syntax:<\/p>\n<p>[URL to report]?comparisonSelect=[feature ID1], [feature ID2], [feature ID3] &#8230;.<\/p>\n<p>For example:<\/p>\n<p><a href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?comparisonSelect=15,Louisiana\" target=\"_blank\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?comparisonSelect=15,Louisiana<\/a><\/p>\n<p>A double map time series report allows you to select different comparison geographies in both maps.<\/p>\n<p>Syntax:<\/p>\n<p>[URL to report]?comparisonSelect=[feature ID]&amp;comparisonSelect2=[feature ID]<\/p>\n<p>For example:<\/p>\n<p><a href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/dmts\/atlas.html?comparisonSelect=15&amp;comparisonSelect2=Louisiana\" target=\"_blank\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/dmts\/atlas.html?comparisonSelect=15&amp;comparisonSelect2=Louisiana<\/a><\/p>\n<h2>Open the Report with a Filter Applied<\/h2>\n<p>Syntax:<\/p>\n<p>[URL to report]?filter=[filter ID],[filter value]<\/p>\n<p>For example:<\/p>\n<p><a target=\"_blank\" href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?filter=filter4,Cajun\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?filter=filter4,Cajun<\/a><\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2015\/08\/image27.jpeg\" alt=\"image27\" class=\"alignnone wp-image-7291 size-full\" width=\"16\" height=\"16\" \/> The filter ID\u2019s can be found by opening the data.js (or data.xml file for Flash reports) of the report in a text editor and searching for \u201cfilter\u201d. The filter ID will be, for example, \u2018filterX\u2019 where X corresponds to the column number in your Geography and Filters worksheet.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2015\/08\/image27.jpeg\" alt=\"image27\" class=\"alignnone wp-image-7291 size-full\" width=\"16\" height=\"16\" \/> If your filter values include spaces or ampersands you will need to replace these special characters in the URL by the following:<\/p>\n<p>Ampersand = %26<\/p>\n<p>Space= %20<\/p>\n<p>You can see an example for this in the example link for double map time series reports below.<\/p>\n<p>Please note that it is not possible to select filter values which contain a comma using URL parameters.<\/p>\n<p>A double map time series report allows you to have a different filter applied in both maps.<\/p>\n<p>Syntax:<\/p>\n<p>[URL to report]? filter=[filter ID],[filter value]&amp; filter2=[filter ID],[filter value]<\/p>\n<p>For example:<\/p>\n<p><a target=\"_blank\" href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/dmts\/atlas.html?filter=filter4,Northern%20Louisiana&amp;filter2=filter4,Cajun\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/dmts\/atlas.html?filter=filter4,Northern%20Louisiana&amp;filter2=filter4,Cajun<\/a><\/p>\n<h2>Open the Report with a Particular Data File Loaded<\/h2>\n<p>Syntax:<\/p>\n<p>[URL to report]?data=[path to the data file minus file extension]<\/p>\n<p>For example:<\/p>\n<p><a target=\"_blank\" href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?data=newdata\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?data=newdata<\/a><\/p>\n<h2>Open the Report with a Particular Configuration File Loaded<\/h2>\n<p>Syntax:<\/p>\n<p>[URL to report]?config=[path to configuration file minus file extension]<\/p>\n<p>For example:<\/p>\n<p><a target=\"_blank\" href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?config=config_largemap\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?config=config_largemap<\/a><\/p>\n<h2>Open the Report with a Particular Stylesheet Loaded<\/h2>\n<p>Syntax:<\/p>\n<p>[URL to report]?style=[path to style sheet file minus file extension]<\/p>\n<p>For example:<\/p>\n<p><a target=\"_blank\" href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?style=default_brown\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?style=default_brown<\/a><\/p>\n<h2>Open the Report with a Particular map.js \/ map.swf.xml File Loaded<\/h2>\n<p>Syntax:<\/p>\n<p>[URL to report]?map=[path to file minus file extension]<\/p>\n<p>For example:<\/p>\n<p><a target=\"_blank\" href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?map=newmap\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?map=newmap<\/a><\/p>\n<h2>Tips<\/h2>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2015\/08\/image27.jpeg\" alt=\"image27\" class=\"alignnone wp-image-7291 size-full\" width=\"16\" height=\"16\" \/> The geographic feature ID, indicator ID, date, filter ID and filter value can all be found within the data.js or data.xml file of the report.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-content\/uploads\/sites\/31\/2015\/08\/image27.jpeg\" alt=\"image27\" class=\"alignnone size-full wp-image-7291\" width=\"16\" height=\"16\" \/> Any of the above parameters can be combined in a URL to trigger multiple actions.\u00a0 For example, to make a report open with a particular indicator selected, a filter applied and a different stylesheet loaded, the URL might look like this:<\/p>\n<p><a target=\"_blank\" href=\"http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?indicator=i2&amp;date=2003&amp;filter=filter4,Cajun&amp;style=default_brown\" rel=\"noopener noreferrer\">http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?indicator=i2&amp;date=2003&amp;filter=filter4,Cajun&amp;style=default_brown<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Introduction You can include parameters in the URL for an InstantAtlas report to trigger various events. For each event, the syntax you should use in the URL is described in the sections below. Open the Report with a Particular Indicator and Time Period Selected Syntax: [URL to report]?indicator=[indicator ID]&amp;date=[date] For example: http:\/\/tools.instantatlas.com\/demos\/v6\/v674\/HTML\/US\/sm\/atlas.html?indicator=i1&amp;date=2003 If the indicator &hellip; <a href=\"https:\/\/help.instantatlas.com\/instantatlas-desktop\/en\/welcome\/support-articles\/including-parameters-in-an-instantatlas-report-url\/\" class=\"more-link\">Continue reading <span class=\"screen-reader-text\">Including Parameters in an InstantAtlas Report URL<\/span><\/a><\/p>\n","protected":false},"author":22,"featured_media":0,"parent":27601,"menu_order":22,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-25172","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/pages\/25172","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/users\/22"}],"replies":[{"embeddable":true,"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/comments?post=25172"}],"version-history":[{"count":0,"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/pages\/25172\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/pages\/27601"}],"wp:attachment":[{"href":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/wp-json\/wp\/v2\/media?parent=25172"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}