> ## Documentation Index
> Fetch the complete documentation index at: https://docs.camo.ag/llms.txt
> Use this file to discover all available pages before exploring further.

# Embedded Map for Brokerages

> Learn how to use and configure the CamoAg Embedded Map feature within your brokerage website or platform.

The CamoAg Embedded Map allows brokerages to integrate an interactive, data-rich land map directly into their own website or customer-facing platform. This guide explains what the Embedded Map offers, when to use it, and how to work with your development team to get it set up.

<Note>
  **For Developers**

  This guide is intended for brokerage users and administrators. If you are a developer responsible for the technical implementation, refer to the [Embed SDK Setup](/developers/embed-sdk/setup) documentation.
</Note>

## What Is the Embedded Map?

The Embedded Map is a fully interactive version of the CamoAg map that can be placed inside an `<iframe>` on your brokerage website. Once embedded, your clients can:

* Browse parcel boundaries, farm sales, soil data, and other map layers
* Search for properties by address or location
* View ownership information and land data without leaving your website
* Use tools such as copy-to-clipboard for parcel IDs and coordinates
* Request their browser location to center the map on their area

The experience feels native to your site while being fully powered by CamoAg's platform.

## Why Use the Embedded Map?

The Embedded Map is ideal for brokerages that want to:

<CardGroup cols={2}>
  <Card title="Keep Clients on Your Site" icon="house">
    Provide clients with powerful land intelligence tools without sending them to a third-party platform.
  </Card>

  <Card title="Showcase Listings in Context" icon="map-pin">
    Display properties, comparable sales, and surrounding data directly within your listing pages.
  </Card>

  <Card title="Differentiate Your Brand" icon="star">
    Offer a premium, data-rich experience that sets your brokerage apart from competitors.
  </Card>

  <Card title="Streamline Workflows" icon="arrows-left-right">
    Allow agents and clients to access parcel data, soils, and sales comps without switching tools.
  </Card>
</CardGroup>

## What Map Layers Are Available?

The following map layers can be enabled in the Embedded Map. Your development team can configure which layers are active by default when the map loads.

| Layer                      | Description                                                          |
| :------------------------- | :------------------------------------------------------------------- |
| **Parcels (Plat Map)**     | Parcel boundaries and ownership information for land across the U.S. |
| **Farm Sales**             | Auction results and sold farm data sourced by CamoAg                 |
| **Sections**               | U.S. Public Land Survey System (PLSS) section boundaries             |
| **Township & Range**       | U.S. Public Land Survey System township and range boundaries         |
| **Counties**               | U.S. county boundaries                                               |
| **States**                 | U.S. state boundaries                                                |
| **Common Land Unit (FSA)** | Farm Service Agency (FSA) common land unit boundaries                |
| **Contours**               | Topographic contour lines                                            |

<Tip>
  Work with your development team to determine which layers are most relevant to your clients and configure them as the default when the map loads.
</Tip>

## Configuring the Default Map View

When a user opens a page containing the Embedded Map, it will center on a default location. Your development team can configure this in two ways:

### Center by Coordinates

The map can be centered on a specific latitude and longitude point. This is useful for brokerage offices that primarily serve a single region.

### Center by Bounding Box

The map can be initialized to fit within a defined geographic area (for example, a specific county or multi-county region). This ensures the most relevant land data is visible immediately on load.

## Iframe Permissions

The Embedded Map relies on two optional browser permissions. Ask your development team to enable whichever features you need:

| Permission        | What It Enables                                                                        |
| :---------------- | :------------------------------------------------------------------------------------- |
| `clipboard-write` | Allows users to copy parcel IDs, coordinates, and other data using in-map copy buttons |
| `geolocation`     | Allows users to center the map on their current location using their browser           |

## Getting Set Up

Setting up the Embedded Map requires a small amount of technical configuration by a developer. Here is an overview of the process so you know what to expect:

<Steps>
  <Step title="Obtain Your Embed Secret">
    An administrator retrieves the embed secret from **CamoAg Account Settings → Embed**. This secret is used by your server to generate secure session URLs and must never be exposed publicly.
  </Step>

  <Step title="Configure a Vanity Domain (Recommended)">
    To ensure the map works correctly for users on Safari and other browsers with strict cookie policies, your team should configure a vanity domain (e.g., `camoag-embed.yourbrokerage.com`). This ensures authentication cookies are treated as first-party.
  </Step>

  <Step title="Generate Signed URLs Server-Side">
    Each time a user loads the embedded map, your server generates a unique signed URL. This URL authenticates the session and directs the map to the correct starting location and layers. Signed URLs expire after 5 minutes if unused.
  </Step>

  <Step title="Add the Iframe to Your Site">
    Your developer places a standard HTML `<iframe>` element on the relevant page(s) of your website and points its `src` attribute to the signed URL. The map will load automatically once the session is verified.
  </Step>
</Steps>

<Warning>
  **Security Reminder**

  The embed secret must only be used in your server-side code. It should never appear in your website's HTML, JavaScript, or any client-facing code.
</Warning>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Do my clients need a CamoAg account to use the Embedded Map?">
    No. The Embedded Map uses a secure session system that authenticates users automatically based on a unique identifier you provide (such as a client ID from your own system). Clients do not need to create or log into a CamoAg account.
  </Accordion>

  <Accordion title="Can I control which layers are visible by default?">
    Yes. Your development team can configure the default layers by appending parameters to the map URL during setup. See the [Embed SDK Setup](/developers/embed-sdk/setup#layers) documentation for the full list of available layer values.
  </Accordion>

  <Accordion title="Will the Embedded Map work on mobile devices?">
    Yes. The CamoAg map is responsive and functions on mobile browsers. If you enable the `geolocation` permission, mobile users can also center the map on their current location.
  </Accordion>

  <Accordion title="How does the Embedded Map handle Safari's cookie restrictions?">
    Safari blocks third-party cookies by default, which can prevent the map from loading inside an iframe on some sites. Configuring a vanity domain that shares the same top-level domain as your website resolves this issue by making the authentication cookies appear as first-party.
  </Accordion>

  <Accordion title="Who do I contact if the Embedded Map is not loading correctly?">
    Contact CamoAg support or your account manager. Have your developer check the browser console for errors and confirm that the signed URL was generated within the last 5 minutes.
  </Accordion>
</AccordionGroup>

## Related Resources

<CardGroup cols={2}>
  <Card title="Embed SDK Setup" icon="code" href="/developers/embed-sdk/setup">
    Technical documentation for developers implementing the Embedded Map.
  </Card>

  <Card title="Overview of Map Layers and Filters" icon="layer-group" href="/map/overview-of-the-map-layers-and-filters">
    Learn about all available map layers and how to use them.
  </Card>

  <Card title="Brokers and Land Managers" icon="users" href="/training/roles/brokers-and-land-managers">
    Quick-link guide covering the most relevant CamoAg features for brokerage professionals.
  </Card>

  <Card title="Embed SDK Events" icon="bolt" href="/developers/embed-sdk/events">
    Reference for JavaScript events emitted by the Embedded Map.
  </Card>
</CardGroup>