Back

RapidMaps 3 Support

RapidMaps 3 Manual

RapidMaps 3 FAQ

RapidMaps 3 API

RapidMaps 3 Manual - 1. What is RapidMaps 3?

RM3-Honeymoon-Project.png

RapidMaps 3 is a RapidWeaver plugin that lets you add create rich and powerful Google Maps in just few clicks.

Show your shop's location, share a route, create professional maps with directions and labels, choose one of 1200+ available Retina icons without writing a single row of code or reading cryptic Google Maps documentation.

Main features

Give directions to your business

Add a label with directions to drive customers to you.

Create professional-looking maps and add even more details with area, path and circle features. Get inspired by RapidMaps sample projects.

No code. No waste of time

Designed to be so easy to use and intuitive, so that your project will be up and running in a glimpse of an eye.

You don't have to write any code or handle cryptic documentation to enjoy all feature of the new and powerful Google Maps v3 framework. Add pins simply by entering an address in the search field or right-clicking on the map, then drag them to adjust position!

Turn up hundreds of icons

RapidMaps leads the way in Google Maps integration offering over 1200 pin Retina icons.

Choose an icon to pick out your store, restaurant, retail outlet or any other point of interest.

2. Requirements and installation >>


RapidMaps 3 Manual - 2. Requirements and installation

RapidMaps requires RapidWeaver� 6.x or higher and an Intel-based Mac. You can buy your RapidWeaver� license from Realmac Software store (RapidWeaver 6.x requires Mac OS X Leopard 10.9 or greater, 50 MB disk space).
RapidMaps pages work with most official and third party themes.

Installation

After downloading RapidMaps plugin from our website, follow instructions on how to install the plugin in the General FAQ section.

RapidMaps is a shareware: please try it before buy it and check whether it suits your needs. After purchasing it on our store, read how to register in the General FAQ section.


Upgrades are available for previous version customers.

<< 1. What is RapidMaps 3?3. Getting started >>


RapidMaps 3 Manual - 3. Getting started

Open your existing RapidWeaver project or create a new one, then add a new page choose RapidMaps from the page types drawer.

RM3-New-Page.png

Converting projects created with previous RapidMaps versions

RapidMaps 1.x and 2.x can automatically and safely be converted to RapidMaps 3.x format opening your existing RapidWeaver saving.

<< 2. Requirements and installation4. Creating your first map >>


RapidMaps 3 Manual - 4. Creating your first map

RM3-Add-Pin.png

You can add a pin in three different ways.

  1. By clicking on the pin icon in left bottom toolbar, a pin will be created at center of the map.
  2. By using "Search location" field on top, a pin will be created on selected location.
  3. By right-clicking directly on the map, a pin will be created on click position.

Groups

You will notice that a group named "Group" has been created.
Groups let you organize pins in sets and enrich data on the map. Download RapidMaps sample projects to enjoy the power of this feature in action.

To add a new group, click on the group icon in left bottom toolbar.
New pins will be created in selected group.

Sorting pins and groups

Pins and groups can be reorganized by selecting and move them in lis view.
This functionality is useful when using path, areas or routes.

Moving and zooming

Published map will reflect center position, zoom level and map type set in RapidMaps editor.
Move your map by dragging it and change zoom and map type, then switch to "Preview" mode to check your customizations.
By double-clicking groups or pins in the list, map will be centered and zoomed to show selected pins.

Removing pins and groups

Pins and can be removed by selecting them in the list and clicking on "Trash" icon on bottom left toolbar.
Pins can also be removed by right-clicking them in the list.

<< 3. Getting started5. Customizing pins and groups >>


RapidMaps 3 Manual - 5. Customizing pins and groups

Pins and groups options can be set using the right panel on RapidMaps interface.
Available settings will be shown when a group or a pin is selected from the list.

RM3-Group-Options.png

Group options

Icon

By clicking on the icon preview beside group name, icon drawer will appear.
You can choose among different icon categories using category dropdown menu on top left.
Search field lets you filter icons in selected category.
Otherwise you can set your own custom icon by selecting "Custom icon" from the dropdown menu.
You need to drag and drop an image onto the grey area and click a point on the image that will appear to select an anchor.
"Retina" options on top lets you set a Retina image for better displaying on iPhone, iPad and Retina Macs. Once you click on "Done" button on bottom right icon will be set for all pin in that group and new pins will use the same icon.

Name

You can set a new group name that will be displayed in the list.
Group name doesn't appear in published map.

Area, circles, path and routes

You can choose to display only pins or other shapes by selecting an option in the "Show" dropdown menu.

Thickness, color and opacity

Area, circle, path and route can be customized using "Stroke" and "Fill" options.

RM3-Pin-Options.png

Pin options

Icon

By clicking on the icon preview beside group name, icon drawer will appear.
You can choose among different icon categories using category dropdown menu on top left.
Search field lets you filter icons in selected category.
Otherwise you can set your own custom icon by selecting "Custom icon" from the dropdown menu.
You need to drag and drop an image onto the grey area and click a point on the image that will appear to select an anchor.
"Retina" options on top lets you set a Retina image for better displaying on iPhone, iPad and Retina Macs. Once you click on "Done" button on bottom right **icon will be set for selected pin.

Name

You can set a new group name that will be displayed in the list.
Pin name will appear in published map when placing the mouse over a pin.

Visibility

By disabling "Visible" option, pin won't appear in published map.
This is useful when you want to display areas, circles or paths.

Latitude and longitude

Pin position can be minutely set by entering Latitude and Longitude values.

Circle radius

When you select "Pins and Circles" in group options, circle radius can be changed.

"On click" option lets you set a behaviour when you click on a pin on published map.

<< 4. Creating your first map6. Customizing the map >>


RapidMaps 3 Manual - 6. Customizing the map

By clicking "Page options" on top right of RapidMaps interface, you can change map settings like size, language or controls, and add services like traffic and weather.

RM3-Options-General.png

Map size

Map size can be set in "General" panel.
Use popup selection to switch between "pixels" and "percentage".
If you want your map to support responsive themes, width unit must be set to "percentage".

Map language

Map language can be set in "General" panel.
RapidMaps supports localization of map and controls in more than 50 languages.

Pins clustering

Pins clustering can be set in "General" panel.
By enabling this options, closed pins are grouped into one element.
This options is suggested when there are a lot of pins on the map.
Clustering is not active in edit mode.

RM3-Options-Controls.png

Controls

Map controls can be set in "Controls" panel.

Map type control can be set as default, dropdown menu or horizontal bar.
Control can be hidden by choosing "Not visible" from the dropdown.
If you want map type control to adapt to responsive layout, choose "Default (responsive)" from the dropdown.

Zoom control can be set as default, small or large.
Control can be hidden by choosing "Not visible" from the dropdown.
If you want zoom control to adapt to responsive layout, choose "Default (responsive)" from the dropdown.

Pan and Street view controls can be hidden by choosing "Not visible" from the dropdown.

By enabling "Scrollwheel zooming", your map can be zoomed in and out using mouse's scrollwheel.

RM3-Options-Services.png

Protocol

Protocol can be set in "Services" panel.
Set it to "HTTP" or "HTTPS" if you want Google Maps Framework to use either.
Set it to "Automatic" if you want Google Maps Framework to use the same protocol of your website.
Please keep in mind that "Automatic" protocol will not work when displaying your exported RapidMaps page on a local machine.

Traffic

Map traffic can be enabled in "Services" panel.
Enable Traffic on map to show real-time traffic information.

Weather

Map weather can be enabled in "Services" panel.
Enable Weather to show current weather conditions with sun, clouds, rain icons and temperature in Fahrenheit or Celsius units.

Enable Clouds to show real-time cloud coverage.

RM3-Options-Feed.png

Feed

Map feed can be set in "Options" panel.
By enabling "Clickable", feed content can be clicked to display available informations.
By disabling "Preserve map center" map will be centered to feed content.

GeoRSS

RapidMaps lets you load feeds with geographic information on your map, called GeoRSS. GeoRSS is designed as a lightweight, community driven way to extend existing feeds with geographic information.
To add your GeoRSS feed, all you have to do is enter the URL of GeoRSS file to load.

KML and KMZ

RapidMaps can import KML or KMZ data. These are file formats used by Google Earth to exchange geographic information. This means that you can view data you create and share with Google Earth through RapidMaps on your map.

How to create KML or KMZ files

You can easily create KMZ files with Google Earth. When you save a placemark or folder from your Places panel you have the choice to save your data as a KMZ file or a KML file.

Please refer to Google Earth Documentation for further information about this feature or take a look at Google KML Tutorial.

RM3-Options-Panoramio.png

Panoramio

Panoramio can be enabled in "Panoramio" panel.
RapidMaps comes with Panoramio integration and lets you add pictures making the most out of the huge Panoramio�s pictures database.

Enable Panoramio integration and use the dropdown menu to choose between "Tag" and "User".

When choosing "Tag" type, enter a topic of your interest ("church", "bridge", "cloud", "river") in the "Value" field and RapidMaps will retrieve pictures from Panoramio database related to that specific topic.

If you want to show picture by a given Panoramio user, enter this information by selecting "User" from type menu and typing username into �Value" field.

<< 5. Customizing pins and groups7. Adding header and footer >>


RapidMaps 3 Manual - 7. Adding header and footer

RM3-Header-Footer.png

By using "Header and Footer" window, you can add custom text above and below the map.
Select "HTML" options to write HTML code or use toolbar for styled text below.

<< 6. Customizing the map


RapidMaps 3 FAQ - What are RapidMaps requirements?

RapidMaps requires RapidWeaver 6.x or higher.
RapidMaps pages work on all themes and on most browsers.

Please try the demo before purchasing it.


RapidMaps 3 FAQ - How do I center the map in the page?

If you want to center the map in the page, you need to use a simple CSS rule.
Copy and paste the following code in "Options" -> "Header" -> "CSS" window of your RapidMaps page.

#rapidmaps-editor { margin: auto; }

RapidMaps 3 FAQ - What are the limitations for unregistered RapidMaps?

An additional pin located on omnidea HQ in Padova (Italy) is added to published page and map is centered on it.


RapidMaps 3 FAQ - After installing RapidMaps, I can't see it in "Add new page" window. What do I need to do?

After installing RapidMaps, you need to restart RapidWeaver.


RapidMaps 3 FAQ - How do I add directions links?

You can display directions links in pins label.

Enter "From here" (or your preferred text) in label field, highlight it and select link option on toolbar below.
Enter %DIRECTIONS_FROM% in URL field and close the window.

Enter "To here" (or your preferred text) in label field, highlight it and select link option on toolbar below.
Enter %DIRECTIONS_TO% in URL field and close the window.

By clicking on "From here" or "To here" links in published map, Google Maps website will be displayed with directions from/to pin location.


RapidMaps 3 FAQ - Why is my RapidMaps 3 page marked as un-registered?

RapidMaps 3 is a paid upgrade for all RapidMaps 2.x customers.

RapidMaps 2.x users need to purchase a upgrade license.
RapidMaps 2.x page contents in your old projects will be preserved.


RapidMaps 3 API - RapidMaps 3 API Guide

Introduction

RapidMaps 2.2.x or higher is required.

You can interact with your RapidMaps page using JavaScript.
For example you can:

More functionalities will be introduced in next updates.

WARNING: you need to have basic JavaScript knowledge in order to use this guide. We don't provide support on generic JavaScript questions.

Available functions

Getting started

When you interact with a group or a pin, you need to specify its ID.
ID is shown when you hold your mouse over a group or a pin in the list.
In following code group's and pin's ID are non-negative integer values indicated respectively as GROUP_ID and PIN_ID.

Group's and pin's IDs

Zoom on a group

Available in RapidMaps 2.2.0.

Code

editor.zoomGroup(GROUP_ID);

Examples

Button

<input type="button" value="Zoom on group" onclick="editor.zoomGroup(0);" />

Link

<a href="javascript:editor.zoomGroup(0);">Zoom on group</a>

Zoom on a pin

Available in RapidMaps 2.2.0.

Code

editor.zoomPin(GROUP_ID, PIN_ID);

Examples

Button

<input type="button" value="Zoom on pin" onclick="editor.zoomPin(0,1);" />

Link

<a href="javascript:editor.zoomPin(0,1);">Zoom on pin</a>

Bounce a pin

Available in RapidMaps 2.2.1.

Set GROUP_ID or PIN_ID to -1 to disable animation.

Code

editor.bouncePin(GROUP_ID, PIN_ID);

Examples

Button

<input type="button" value="Bounce pin" onclick="editor.bouncePin(0,0);" />

Link

<a href="javascript:editor.bouncePin(0,0);">Bounce pin</a>

Show pin's label

Available in RapidMaps 2.2.1.

Set GROUP_ID or PIN_ID to -1 to hide all labels.

Code

editor.showLabel(GROUP_ID, PIN_ID);

Examples

Button

<input type="button" value="Show label" onclick="editor.showLabel(0,0);" />

Link

<a href="javascript:editor.showLabel(0,0);">Show label</a>

Show group's pins

Available in RapidMaps 2.4.0.

Set GROUP_ID to -1 to hide all pins or to -2 to show all pins.

Code

editor.showGroup(GROUP_ID);

Examples

Button

<input type="button" value="Show group" onclick="editor.showGroup(0);" />

Link

<a href="javascript:editor.showGroup(0);">Show group</a>

Show group's area

Available in RapidMaps 2.2.1.

Set GROUP_ID to -1 hide all areas or to -2 to show all areas.

Code

editor.showArea(GROUP_ID);

Examples

Button

<input type="button" value="Show area" onclick="editor.showArea(1);" />

Link

<a href="javascript:editor.showArea(1);">Show area</a>

Show group's path

Available in RapidMaps 2.2.1.

Set GROUP_ID to -1 hide all paths or to -2 to show all paths.

Code

editor.showPath(GROUP_ID);

Examples

Button

<input type="button" value="Show path" onclick="editor.showPath(1);" />

Link

<a href="javascript:editor.showPath(1);">Show path</a>

Show group's circles

Available in RapidMaps 2.2.1.

Set GROUP_ID to -1 hide all circles or to -2 to show all circles.

Code

editor.showCircles(GROUP_ID);

Examples

Button

<input type="button" value="Show circles" onclick="editor.showCircles(1);" />

Link

<a href="javascript:editor.showCircles(1);">Show circles</a>

Demo project

Download the following demo project that shows you how to use RapidMaps 2 API in Header/Footer section.

RapidMaps_2_API.rwsw.zip