---
title: 1map Web Viewer
description: The Web viewer integrates with your software through the API to provide access to 1map layers within your application, quickly and easily delivering the spatial picture for the data you are using.
---
[Skip to content](https://help.1map.co.za/knowledge/1map-web-viewer#main-content)
English
Show submenu for translations
![logo-whte-1.png\]](https://help.1map.co.za/hs-fs/hubfs/logo-whte-1.png?height=50&name=logo-whte-1.png)
Open main navigation
Close main navigation
- English
Show submenu for translations
- Go to 1map.co.za
Go to 1map.co.za
Hello. How can we help you?
- There are no suggestions because the search field is empty.
1. [Help Centre](https://help.1map.co.za/knowledge?hsLang=en)
2. [1map Embeddable Viewer](https://help.1map.co.za/knowledge/1map-embeddable-viewer?hsLang=en)
# 1map Web Viewer
## The Web viewer integrates with your software through the API to provide access to 1map layers within your application, quickly and easily delivering the spatial picture for the data you are using.
1. **Before you access the Viewer**
User your 1map username and password to obtain a token, this token will be passed as a URL parameter to the online Viewer
Make sure to get your token in the back end as not to expose your username and password in the front end.
Here is sample code for retrieving your token (Adjust to the back end language you are using.):
```
var 1mapUsername = "map_viewer@1map.co.za";var 1mapPassword = "map_viewer98";var token = "";var jqxhr = $.ajax({ type: "GET", url: "https://www.1map.co.za/api/v1/auth/login/", dataType: "json", timeout: 60000 * 2, // 2 minutes data: { email: TEMPmapUsername, password: TEMPmapPassword,},error: function (xhr, status, error) { // alert(error);},success: function (response) { if (response && response.result) { token = response.apiToken.token; if (response.result.maprestriction) { maprestriction = response.result.maprestriction; } }}, async: false,});
```
2. **Determine the LayerID needed for the viewer to start up with.**
Each 1map account has specific access to certain layers in 1map.
There are currently two ways to access the list of Layer IDs per account:
1. **Using the API**
You can also run the following API in the back end to access the available layers per account:
```
var jqxhr = $.ajax({type: "GET",url: "https://www.1map.co.za/api/v1/params/layer/",dataType: "json",timeout: 60000 * 2, // 2 minutesdata: {token: "31dd6a5a-58cb-4619-b173-134b17ee81cf ",},error: function (xhr, status, error) {// alert(error);},if (response && response.result) {//Get LayerID from result} async: false,});
```
2. **Using the Viewer tiptool**:
Access the viewer with a 1map account and retrieved token.
Make the required layer Active in the Layer picker:
Hover over the title of the Active Layer to see the LayerID as a tooltip.
3. **Viewer URL**
**Use the following URL to Access the Viewer: **
http://viewer.1map.co.za/index.html?token=\[place your token here\]&LayerID=\[Place your LayerID here\]
**Example:**
http://viewer.1map.co.za/index.html?token= 31dd6a5a-58cb-4619-b173-134b17ee81cf&LayerID=1577
4. ****Sending additional Parameters to the Viewer for use on startup.****
**You may need the map to open and auto navigate to a specific feature, for example a property.**
**This can be achieved by passing the correct URL parameter in the URL relevant to the LayerID.**
**Example 1:**
http://viewer.1map.co.za/index.html?token= 31dd6a5a-58cb-4619-b173-134b17ee81cf&LayerID=1577&allotmntno=C0460014
**Result:**
****
**Example 2:**
http://viewer.1map.co.za/index.html?token= 31dd6a5a-58cb-4619-b173-134b17ee81cf&LayerID=1577&allotmntno=C0460014 &standno=00007367
**Result:**
****
**Example 3:**
http://viewer.1map.co.za/index.html?token= 31dd6a5a-58cb-4619-b173-134b17ee81cf&LayerID=2450&mun\_deed=T45341
**Result:**
**Note:**
**To see the names of the parameters per layer, select a feature on the map and hover over the display name of the attribute. The parameter name will display in the tooltip.**
**Only parameters that have indexes in are valid parameters in the URL.**
**Should you require parameters to be indexed, kindly request this from our support team.**
**Getting the Selected Feature information back from the Viewer to your application**
You may require the attribute information of a selected feature back in your application.
To do this, provide the name of a hidden input field from your application in the URL as follows:
http://viewer.1map.co.za/index.html?token= 31dd6a5a-58cb-4619-b173-134b17ee81cf&LayerID=2450&mun\_deed=T45341&openerAttributes=hdnAttributes
Every time the user selects a different feature the matching attributes will be passed back to your application’s hidden input field as a JSON string.
Here is our code to achieve this:
parent.document.getElementById(openerAttributes).value = JSONattributes;
- [Getting Started](https://help.1map.co.za/knowledge/getting-started?hsLang=en)
- [Finding a property](https://help.1map.co.za/knowledge/finding-a-property?hsLang=en#main-content)
- [Basic](https://help.1map.co.za/knowledge/finding-a-property?hsLang=en#basic)
- [Available Search Methods](https://help.1map.co.za/knowledge/finding-a-property?hsLang=en#available-search-methods)
- [Property Information](https://help.1map.co.za/knowledge/finding-a-property?hsLang=en#property-information)
- [Q+A](https://help.1map.co.za/knowledge/finding-a-property?hsLang=en#qa)
- [Utilities and Tools](https://help.1map.co.za/knowledge/utilities-and-tools?hsLang=en)
- [Layers](https://help.1map.co.za/knowledge/layers?hsLang=en#main-content)
- [Layers](https://help.1map.co.za/knowledge/layers?hsLang=en#layers)
- [Workspaces](https://help.1map.co.za/knowledge/layers?hsLang=en#workspaces)
- [Survey Diagrams](https://help.1map.co.za/knowledge/survey-diagrams?hsLang=en#main-content)
- [Diagrams](https://help.1map.co.za/knowledge/survey-diagrams?hsLang=en#diagrams)
- [Survey Records](https://help.1map.co.za/knowledge/survey-diagrams?hsLang=en#survey-records)
- [GeoRef](https://help.1map.co.za/knowledge/survey-diagrams?hsLang=en#georef)
- [DALRRD](https://help.1map.co.za/knowledge/survey-diagrams?hsLang=en#dalrrd)
- [Bookmarks](https://help.1map.co.za/knowledge/bookmarks?hsLang=en)
- [NetworkManager Guide](https://help.1map.co.za/knowledge/networkmanager-guide?hsLang=en)
- [Spatial Editing](https://help.1map.co.za/knowledge/spatial-editing?hsLang=en)
- [Attribute Editing](https://help.1map.co.za/knowledge/attribute-editing?hsLang=en)
- [Printing](https://help.1map.co.za/knowledge/printing?hsLang=en)
- [Exporting Data](https://help.1map.co.za/knowledge/exporting-data?hsLang=en)
- [Uploading Your Own Data](https://help.1map.co.za/knowledge/uploading-your-own-data?hsLang=en)
- [Collaborate with MapBall](https://help.1map.co.za/knowledge/collaborate-with-mapball?hsLang=en)
- [1map Mobile](https://help.1map.co.za/knowledge/1map-mobile?hsLang=en#main-content)
- [read more](https://help.1map.co.za/knowledge/1map-mobile?hsLang=en#read-more)
- [Getting Started](https://help.1map.co.za/knowledge/1map-mobile?hsLang=en#getting-started)
- [Mobile application (for Private Client)](https://help.1map.co.za/knowledge/mobile-application-for-private-client?hsLang=en)
- [Frequently Asked Questions](https://help.1map.co.za/knowledge/frequently-asked-questions?hsLang=en)
- [New Features](https://help.1map.co.za/knowledge/new-features?hsLang=en#main-content)
- [May 2023](https://help.1map.co.za/knowledge/new-features?hsLang=en#may-2023)
- [October 2022](https://help.1map.co.za/knowledge/new-features?hsLang=en#october-2022)
- [September 2022](https://help.1map.co.za/knowledge/new-features?hsLang=en#september-2022)
- [Earlier](https://help.1map.co.za/knowledge/new-features?hsLang=en#earlier)
- [1map Embeddable Viewer](https://help.1map.co.za/knowledge/1map-embeddable-viewer?hsLang=en)
- [Financial Integration for a Municipality](https://help.1map.co.za/knowledge/financial-integration-for-a-municipality?hsLang=en#main-content)
- [Phase 1 - Obtain Data](https://help.1map.co.za/knowledge/financial-integration-for-a-municipality?hsLang=en#phase-1-obtain-data)
- [Phase 2 - Convert & Map Data (Data Integration)](https://help.1map.co.za/knowledge/financial-integration-for-a-municipality?hsLang=en#phase-2-convert-map-data-data-integration)
- [Internal](https://help.1map.co.za/knowledge/internal?hsLang=en)
- [1map Subscriptions](https://help.1map.co.za/knowledge/1map-subscriptions?hsLang=en)
- [Quidity](https://help.1map.co.za/knowledge/quidity?hsLang=en)
- [Emalahleni](https://help.1map.co.za/knowledge/emalahleni?hsLang=en)
- [CityManager](https://help.1map.co.za/knowledge/citymanager?hsLang=en#main-content)
- [Service Delivery](https://help.1map.co.za/knowledge/citymanager?hsLang=en#service-delivery)
- [Mobile](https://help.1map.co.za/knowledge/citymanager?hsLang=en#mobile)
- [User Management](https://help.1map.co.za/knowledge/user-management?hsLang=en)
- [1map Widget](https://help.1map.co.za/knowledge/1map-widget?hsLang=en)
- [FiberTime](https://help.1map.co.za/knowledge/fibertime?hsLang=en#main-content)
- [Desktop](https://help.1map.co.za/knowledge/fibertime?hsLang=en#desktop)
- [SG Lodgements](https://help.1map.co.za/knowledge/sg-lodgements?hsLang=en)
- [Pvt](https://help.1map.co.za/knowledge/pvt?hsLang=en)
- [RevenueManager](https://help.1map.co.za/knowledge/revenuemanager?hsLang=en)
[](https://help.1map.co.za/?hsLang=en)
1map Help Centre
Copyright © 2026, 1map Spatial Solutions (Pty) Ltd