Quick Start

Get started with MapQube in just a few minutes.

1. Create an Account

Sign up for a free account to get started with MapQube. Free tier includes 3 maps with 10,000 views/month.

2. Create Your First Map

Navigate to your dashboard and click "Create New Map". Use the editor to add markers, lines, polygons, and 3D objects.

3. Customize Your Map

Add markers with custom icons and colors, draw boundaries, upload 3D models, and style your map with titles and descriptions.

4. Publish Your Map

Click the "Publish" button to make your map publicly accessible and get your unique map ID.

5. Get the Embed Code

Copy the iframe embed code from your dashboard or use the map URL: https://mapqube.com/map/YOUR_MAP_ID

6. Embed on Your Website

Paste the iframe code into your HTML. Customize with query parameters for different looks and behaviors.

📋 How to Get Your Map ID

Your Map ID is required for embedding. Here's how to find it:

Method 1: From Dashboard

  1. Open your MapQube dashboard
  2. Find your published map in the list
  3. Click on "View" or "Share" button
  4. Copy the Map ID or full URL displayed

Method 2: From URL

When viewing your published map, the URL format is:

https://mapqube.com/map/abc-123-def-456

The highlighted part is your Map ID

Method 3: Copy Embed Code

Click the "Get Embed Code" button in your dashboard to get a pre-filled iframe code with your Map ID included.

Embedding Maps

Learn how to embed your maps on any website with full customization options.

Basic Embed Code

Copy and paste this code into your HTML to embed a map:

<iframe src="https://mapqube.com/map/YOUR_MAP_ID"
  width="100%"
  height="600"
  frameborder="0"
  allowfullscreen>
</iframe>

💡 Tip: Replace YOUR_MAP_ID with your actual map ID from your dashboard.

Responsive Embed

For maps that adapt to different screen sizes (16:9 aspect ratio):

<div style="position: relative; padding-bottom: 56.25%; height: 0;">
  <iframe src="https://mapqube.com/map/YOUR_MAP_ID"
    style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
    frameborder="0"
    allowfullscreen>
  </iframe>
</div>

Full-Width Hero Section

Perfect for landing pages and hero sections:

<div style="width: 100%; height: 100vh;">
  <iframe src="https://mapqube.com/map/YOUR_MAP_ID?header=true"
    style="width: 100%; height: 100%;"
    frameborder="0"
    allowfullscreen>
  </iframe>
</div>

Customization with Query Parameters

Customize your embedded map by adding query parameters to the URL:

Parameter Type Default Description
header boolean false Show map title and description header
tilt number 65 Camera tilt angle (0-85 degrees)
fadeEdges number 10 Edge fade amount in pixels (0 to disable)
transparentBackground boolean true Enable transparent background
padding number 10 Fit bounds padding in pixels
allowedMaps string all Comma-separated map types: standard, satellite, outdoors, dark, light
showUserLocation boolean false Display user's current location on map

Example Configurations

🎯 Minimal Embed (No Header, Flat View)

Perfect for subtle map placements with no 3D tilt

https://mapqube.com/map/YOUR_MAP_ID?tilt=0&fadeEdges=0

📍 Location-Aware Map

Shows user's location with map controls

https://mapqube.com/map/YOUR_MAP_ID?showUserLocation=true&header=true

🎨 Dark Mode Only

Restricts to dark map style only

https://mapqube.com/map/YOUR_MAP_ID?allowedMaps=dark&tilt=45

🏢 Real Estate Showcase

Full header with custom padding and satellite view

https://mapqube.com/map/YOUR_MAP_ID?header=true&allowedMaps=satellite,standard&padding=50

🌍 Full Customization

All options combined

https://mapqube.com/map/YOUR_MAP_ID?header=true&tilt=45&fadeEdges=5&transparentBackground=false&padding=20&allowedMaps=standard,satellite&showUserLocation=true

Best Practices

Use Responsive Containers:

Always wrap iframes in responsive containers for better mobile experience

Set Appropriate Height:

Use minimum 400px height for optimal viewing experience

Test Loading Speed:

Our embeds are optimized (~800KB gzipped), loads in under 2 seconds on 3G

Enable HTTPS:

For security, always embed on HTTPS websites

Choose Header Wisely:

Use header=true for standalone maps, omit for subtle integrations

Performance Optimized

MapQube embeds use a lightweight bundle (~800KB gzipped) separate from the main app. This means faster loading times and better user experience. Maps load in 600ms-1.5s on 3G connections.

Platform Features

📍

Custom Markers & Pins

Add unlimited markers with custom icons, colors, titles, and descriptions. Perfect for location-based content.

🎨

Multiple Map Styles

Choose from Standard, Satellite, Outdoors, Dark, and Light themes to match your brand.

📦

3D Objects

Upload and place custom 3D objects (.glb/.gltf) on your maps for immersive experiences.

📊

Analytics Dashboard

Track views and engagement for your embedded maps with real-time analytics.

Lightning Fast

Optimized embeds (~800KB) load in under 2 seconds on 3G connections.

🔒

Secure & Reliable

Enterprise-grade security with Firebase backend and 99.9% uptime guarantee.

📱

Fully Responsive

Maps automatically adapt to any screen size - desktop, tablet, or mobile.

🌍

User Location

Show visitor's current location on maps with the showUserLocation parameter.

Troubleshooting

Map Not Loading / Shows "Map Not Found"

Possible causes:

  • Map is not published - Check your dashboard and click "Publish"
  • Incorrect Map ID - Verify the ID matches exactly
  • Map was deleted - Restore from dashboard if available

Embed Shows "View Limit Reached"

Solution: Your map has reached its monthly view limit. Upgrade your subscription plan to increase limits:

  • Free: 10,000 views/month per map
  • Pro (₹2,400/mo): 100,000 views/month per map
  • Enterprise (₹8,200/mo): Unlimited views

Map Loading Slowly

Tips to improve performance:

  • Reduce the number of 3D objects on your map
  • Optimize 3D model file sizes before uploading
  • Use transparent backgrounds: transparentBackground=true
  • Consider using fewer map style options with allowedMaps

Iframe Not Displaying on My Website

Check these items:

  • Set explicit width and height on iframe element
  • Ensure your website is served over HTTPS
  • Check browser console for security/CORS errors
  • Verify iframe is not blocked by Content Security Policy (CSP)
  • Test in incognito mode to rule out browser extensions

User Location Not Showing

Requirements:

  • Add ?showUserLocation=true to your map URL
  • Users must grant location permission in their browser
  • Website must be served over HTTPS (required for geolocation API)
  • May not work in some privacy-focused browsers or with VPN

Still having issues? Contact our support team at support page or email us at support@mapqube.com

API Reference

For detailed API documentation, programmatic access, and webhooks, please visit our API page.

💡 Common Use Cases

See how businesses and developers are using MapQube:

🏢 Real Estate Listings

Showcase properties with interactive 3D maps, nearby amenities, and custom markers.

?header=true&allowedMaps=satellite,standard&tilt=45

🎪 Event Location Pages

Help attendees find venues with user location and clear directions.

?showUserLocation=true&header=true&padding=50

🏪 Store Locators

Display multiple store locations with custom markers and detailed information.

?allowedMaps=standard&showUserLocation=true&tilt=0

🏛️ Tourism & Travel

Create interactive tour guides with points of interest and 3D landmarks.

?header=true&allowedMaps=outdoors,satellite&tilt=65

📍 Service Area Maps

Show coverage areas with boundaries and service center locations.

?transparentBackground=false&fadeEdges=0&tilt=0

🎨 Portfolio Projects

Designers and developers showcasing location-based work.

?allowedMaps=dark&header=true&fadeEdges=15

Need Help?

If you have any questions or need assistance, our support team is here to help.

Email Support

Get help via email

support@mapqube.com

Contact Form

Fill out our contact form

Contact Us →

Documentation

Browse our guides

View Docs →

Response Times

Free Plan

48 hours

Pro Plan

24 hours

Enterprise Plan

4 hours