{"id":2462,"date":"2022-03-14T10:25:31","date_gmt":"2022-03-14T10:25:31","guid":{"rendered":"https:\/\/researchframeworks.org\/?page_id=2268"},"modified":"2022-03-31T15:45:39","modified_gmt":"2022-03-31T15:45:39","slug":"guide-to-adding-maps-to-your-rf","status":"publish","type":"page","link":"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/","title":{"rendered":"Guide to adding maps to your RF"},"content":{"rendered":"\n

Preparing the map data for upload to the map feature<\/strong><\/h2>\n\n\n\n

Map data can be either in polygon or point format contained within a .CSV file ready for upload. <\/p>\n\n\n\n

Ensure that the .CSV file is set up with following headings – Title, Content, Link URL, Image, Geo, Marker Icon and Categories<\/p>\n\n\n\n

Don\u2019t worry if there is no data in a field on the .CSV file, not all fields need to be filled.  <\/p>\n\n\n\n

Map information can be added as lat\/long, NGR, or eastings and northings – the system will convert to lat\/long. <\/p>\n\n\n\n

Adding maps to the Framework Site<\/strong><\/h2>\n\n\n\n

Adding maps to the Framework site is a two stage process.  First you need to create the map, and then add it to a page.<\/p>\n\n\n\n

Creating a map<\/strong><\/h2>\n\n\n\n

Click on Maps<\/em> on left Dashboard menu and click Add New.<\/em><\/p>\n\n\n\n

This will open what looks like a page editor, but is actually a map editor. Give your map a title.<\/p>\n\n\n\n

Uploading Feature data<\/strong><\/h2>\n\n\n\n

This is the information which displays the map, and where you can enter the data.  It is possible to enter each point or polygon manually, but we recommend that points are entered as a .CSV upload, you may find that polygons have too much data for a .CSV file and therefore will need copying from a notepad file.<\/p>\n\n\n\n

CSV file uploading feature data<\/strong><\/h3>\n\n\n\n

Ensure that your data columns match the Features headings (see below). <\/p>\n\n\n\n

\"\"
Headings for the CSV file<\/figcaption><\/figure>\n\n\n\n

Move down to the bottom of the page to CSV Upload<\/em> and click on Add file<\/em>. The media library will open and you can choose a .CSV file already there or upload a new file.<\/p>\n\n\n\n

\"\"
Uploading a CSV file to the map<\/figcaption><\/figure><\/div>\n\n\n\n

This will then import the data into the map.<\/p>\n\n\n\n

\"\"
The Geo spatial data from the spreadsheet in the map<\/figcaption><\/figure>\n\n\n\n

Polygon uploading<\/strong> geo data<\/strong><\/h3>\n\n\n\n

Polygons are likely to have too much information for a .CSV file, so with polygons it is best to use notepad – save the datapoints into a notepad and then copy and paste into the Geo<\/em> field.<\/p>\n\n\n\n

\"\"
Polygon data for ‘London’ region – can be copied directly into the geo box in features <\/figcaption><\/figure>\n\n\n\n

Creating GEOJSON files for upload<\/h3>\n\n\n\n

The above polygon text was taken from a GeoJson file of a map drawn on the http:\/\/geojson.io<\/a> website – here you can create polygons by drawing boundaries, and then save the resulting feature data as a .geojson file (which opens in notepad).<\/p>\n\n\n\n

\"\"
Geojson map with South West Region polygon drawn<\/figcaption><\/figure>\n\n\n\n

Once the data is imported Update<\/em> the map (top right corner).<\/p>\n\n\n\n

Displaying point\/polygon information<\/h2>\n\n\n\n

There are two methods for displaying any information about the data, either Popup or Infobar. Which you choose depends on the amount of information; it is best to choose the same style for all the maps on your site.<\/p>\n\n\n\n

In the Info View<\/em><\/strong> choose the format you\u2019d like the information about your points on the map to show.<\/p>\n\n\n\n

The information displayed in the Popup or Infobar is taken from the Content<\/em> field of the data – you can put any information here.<\/p>\n\n\n\n

If your map points have more information choose the Infobar, if you\u2019re just putting a bit of short text then Popup is sufficient \u2013 you can change this later if you wish.<\/p>\n\n\n\n

\"\"
Example of an Infobar – for more information text which can be formatted.<\/figcaption><\/figure>\n\n\n\n
\"\"
Example of a popup – better for small amount of text.<\/figcaption><\/figure>\n\n\n\n

You can also set the Map Height<\/em><\/strong> on the web page, this defaults to 400 pixels, but if you have a lot of detail on the map that might not be enough and you can increase it (do not go above 700 pixels).<\/p>\n\n\n\n

Making changes to the map information<\/h2>\n\n\n\n

If you need to make changes to the map points or polygons, or any of the text is is best to do this within the original CSV file and re-upload to the media library.<\/p>\n\n\n\n

If you make any changes and need to upload a new .CSV file, note that uploading a new file will overwrite earlier files. <\/p>\n\n\n\n

Manually uploading feature data<\/strong><\/h2>\n\n\n\n

If you have a small amount of data it is possible to manually upload to the database instead of using a .CSV file.<\/p>\n\n\n\n

Click Add Row<\/em> in the Features<\/em> menu, which will open a series of boxes;<\/p>\n\n\n\n

\"\"
Manually adding a row to the features<\/figcaption><\/figure>\n\n\n\n

Title of the point or polygon, the information you put in the Content field will appear in either the pop up or Info bar (can be text or an image), link URL can be to any page on the site (or external, this is not advised), an image can be added (this will need to be in the media folder), Marker icon is default (but also see below), and categories will be discussed later. <\/p>\n\n\n\n

The only box which is required is Geo<\/em>, which is where the spatial data such as lat\/long or NGR for points, or polygons is located. <\/p>\n\n\n\n

Enter the information in the required fields, each row will be a single point or polygon.<\/p>\n\n\n\n

Adding the map to a page to view on the site<\/h2>\n\n\n\n

In order to view the map, and check that everything displays correctly you will need to embed it into a page.<\/p>\n\n\n\n

Choose the page you wish to have the map on, and open it for editing (or create a new page).<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

A map is a block like paragraphs or images, and is added in the same way. Click on the Add block symbol, to open the dialogue box, and choose or search for maps<\/em>.<\/p>\n\n\n\n

\"\"
Choose or search for map<\/em><\/figcaption><\/figure><\/div>\n\n\n\n

This will place a map block onto the page, in the right hand menu select the map you wish to add.<\/p>\n\n\n\n

\"\"
Select the required map in the dropdown on the right<\/figcaption><\/figure>\n\n\n\n

The map will then appear on the page.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n
\"\"
Choose full width<\/figcaption><\/figure><\/div>\n\n\n\n

At this point is a good idea to open another browser tab and view the page to be sure that the map is displaying correctly.<\/p>\n\n\n\n

If your map is on a web page on it’s own with no headings, it is best to change the default display for the page to remove the left menu bar, do this by clicking on page<\/em> in the top right corner. <\/p>\n\n\n\n

Under template<\/em> choose Full width<\/em>.<\/p>\n\n\n\n

Changing<\/strong> Point map markers<\/strong> <\/h2>\n\n\n\n

Each point feature on a map has a marker (polygons do not have markers), this can be an image of a pin, a drop or whatever you\u2019d like.   <\/p>\n\n\n\n

\"\"
Default map marker<\/figcaption><\/figure><\/div>\n\n\n\n

The system has a default marker, but you can change it if you wish; you could decide to have different colours for different types of find spot for instance. <\/p>\n\n\n\n

These need to be a small image (a .png file which is 60px by 80px), with a transparent background.\u00a0 When you have your image you\u2019ll need to upload it to the media section of the website as you would any image.<\/p>\n\n\n\n

Once uploaded to the Media library<\/em>, find the image you wish to use.  Click on it in the Media library to open the details.  You then need to look at the URL at the top of the page and make a note of the item number.<\/p>\n\n\n\n

\"\"
Make a note of the item number for the image<\/figcaption><\/figure>\n\n\n\n

If you are using a custom point marker, take the item number you noted in the Media Library for the marker image you wish to use (in the example above this was \u2018171\u2019), ensure that this is in the entered on the spreadsheet in the Marker Icon<\/em> field for each line.<\/p>\n","protected":false},"excerpt":{"rendered":"

Preparing the map data for upload to the map feature Map data can be either in polygon or point format contained within a .CSV file ready for upload.  Ensure that the .CSV file is set up with following headings – Title, Content, Link URL, Image, Geo, Marker Icon and Categories Don\u2019t worry if there is […]<\/p>\n","protected":false},"author":567,"featured_media":2471,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"class_list":["post-2462","page","type-page","status-publish","has-post-thumbnail","hentry"],"acf":[],"yoast_head":"\nGuide to adding maps to your RF - Help and Resources for site owners<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Guide to adding maps to your RF - Help and Resources for site owners\" \/>\n<meta property=\"og:description\" content=\"Preparing the map data for upload to the map feature Map data can be either in polygon or point format contained within a .CSV file ready for upload.  Ensure that the .CSV file is set up with following headings – Title, Content, Link URL, Image, Geo, Marker Icon and Categories Don\u2019t worry if there is […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/\" \/>\n<meta property=\"og:site_name\" content=\"Help and Resources for site owners\" \/>\n<meta property=\"article:modified_time\" content=\"2022-03-31T15:45:39+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/researchframeworks.org\/resources\/wp-content\/uploads\/sites\/26\/2022\/03\/bernard-hermant-VUBAE-Bmugk-unsplash-scaled.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"2560\" \/>\n\t<meta property=\"og:image:height\" content=\"1707\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"9 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/\",\"url\":\"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/\",\"name\":\"Guide to adding maps to your RF - Help and Resources for site owners\",\"isPartOf\":{\"@id\":\"https:\/\/researchframeworks.org\/resources\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/researchframeworks.org\/resources\/wp-content\/uploads\/sites\/26\/2022\/03\/bernard-hermant-VUBAE-Bmugk-unsplash-scaled.jpg\",\"datePublished\":\"2022-03-14T10:25:31+00:00\",\"dateModified\":\"2022-03-31T15:45:39+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/#primaryimage\",\"url\":\"https:\/\/researchframeworks.org\/resources\/wp-content\/uploads\/sites\/26\/2022\/03\/bernard-hermant-VUBAE-Bmugk-unsplash-scaled.jpg\",\"contentUrl\":\"https:\/\/researchframeworks.org\/resources\/wp-content\/uploads\/sites\/26\/2022\/03\/bernard-hermant-VUBAE-Bmugk-unsplash-scaled.jpg\",\"width\":2560,\"height\":1707},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/researchframeworks.org\/resources\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Guide to adding maps to your RF\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/researchframeworks.org\/resources\/#website\",\"url\":\"https:\/\/researchframeworks.org\/resources\/\",\"name\":\"Help and Resources for site owners\",\"description\":\"For admins & content managers\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/researchframeworks.org\/resources\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Guide to adding maps to your RF - Help and Resources for site owners","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/","og_locale":"en_US","og_type":"article","og_title":"Guide to adding maps to your RF - Help and Resources for site owners","og_description":"Preparing the map data for upload to the map feature Map data can be either in polygon or point format contained within a .CSV file ready for upload.  Ensure that the .CSV file is set up with following headings – Title, Content, Link URL, Image, Geo, Marker Icon and Categories Don\u2019t worry if there is […]","og_url":"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/","og_site_name":"Help and Resources for site owners","article_modified_time":"2022-03-31T15:45:39+00:00","og_image":[{"width":2560,"height":1707,"url":"https:\/\/researchframeworks.org\/resources\/wp-content\/uploads\/sites\/26\/2022\/03\/bernard-hermant-VUBAE-Bmugk-unsplash-scaled.jpg","type":"image\/jpeg"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"9 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/","url":"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/","name":"Guide to adding maps to your RF - Help and Resources for site owners","isPartOf":{"@id":"https:\/\/researchframeworks.org\/resources\/#website"},"primaryImageOfPage":{"@id":"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/#primaryimage"},"image":{"@id":"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/#primaryimage"},"thumbnailUrl":"https:\/\/researchframeworks.org\/resources\/wp-content\/uploads\/sites\/26\/2022\/03\/bernard-hermant-VUBAE-Bmugk-unsplash-scaled.jpg","datePublished":"2022-03-14T10:25:31+00:00","dateModified":"2022-03-31T15:45:39+00:00","breadcrumb":{"@id":"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/#primaryimage","url":"https:\/\/researchframeworks.org\/resources\/wp-content\/uploads\/sites\/26\/2022\/03\/bernard-hermant-VUBAE-Bmugk-unsplash-scaled.jpg","contentUrl":"https:\/\/researchframeworks.org\/resources\/wp-content\/uploads\/sites\/26\/2022\/03\/bernard-hermant-VUBAE-Bmugk-unsplash-scaled.jpg","width":2560,"height":1707},{"@type":"BreadcrumbList","@id":"https:\/\/researchframeworks.org\/resources\/guide-to-adding-maps-to-your-rf\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/researchframeworks.org\/resources\/"},{"@type":"ListItem","position":2,"name":"Guide to adding maps to your RF"}]},{"@type":"WebSite","@id":"https:\/\/researchframeworks.org\/resources\/#website","url":"https:\/\/researchframeworks.org\/resources\/","name":"Help and Resources for site owners","description":"For admins & content managers","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/researchframeworks.org\/resources\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/researchframeworks.org\/resources\/wp-json\/wp\/v2\/pages\/2462","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/researchframeworks.org\/resources\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/researchframeworks.org\/resources\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/researchframeworks.org\/resources\/wp-json\/wp\/v2\/users\/567"}],"replies":[{"embeddable":true,"href":"https:\/\/researchframeworks.org\/resources\/wp-json\/wp\/v2\/comments?post=2462"}],"version-history":[{"count":3,"href":"https:\/\/researchframeworks.org\/resources\/wp-json\/wp\/v2\/pages\/2462\/revisions"}],"predecessor-version":[{"id":2481,"href":"https:\/\/researchframeworks.org\/resources\/wp-json\/wp\/v2\/pages\/2462\/revisions\/2481"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/researchframeworks.org\/resources\/wp-json\/wp\/v2\/media\/2471"}],"wp:attachment":[{"href":"https:\/\/researchframeworks.org\/resources\/wp-json\/wp\/v2\/media?parent=2462"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}