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

# Google Maps QR Code

> Create a QR Code that opens a location in Google Maps or in OpenStreetMap with a single tap, so scanners get directions without typing any address in.

## What it's for

A Google Maps QR Code opens a specific location — a store, a venue, a booth — directly in Google Maps when scanned, with one tap to get directions. It's a **Quick Code**: a direct-action QR Code with no landing page, built by picking a place on a map rather than filling out a form.

<Note>
  Unlike most Quick Code types, Google Maps supports **both Dynamic and Static** QR Codes — the location, short URL, and Advanced settings described below only apply to the Dynamic option.
</Note>

## Create a Google Maps QR Code

<Steps>
  <Step title="Open Create QR Code and choose Quick Code">
    From the sidebar, go to **QR Codes**, then click **Create QR Code** (or navigate to `/qr/create`). Click the **Quick Code** card.
  </Step>

  <Step title="Pick Google Maps">
    On the **Quick Code** type grid, click **Configure** under **Google Maps**. This opens the form at `/qr/quick/maps`.
  </Step>

  <Step title="Choose a map provider">
    The **Map provider** toggle offers **Google** and **OpenStreetMap** — OpenStreetMap is selected by default. This choice only affects which map widget you use to *find and preview* the location; picking a place on the Google widget shows a static preview image with the note "Dragging the pin needs the OpenStreetMap provider — this map is a static preview," while OpenStreetMap gives you an interactive, draggable pin.

    <Frame caption="The provider toggle set to Google, showing a static preview map">
      <img src="https://mintcdn.com/scanova-api/GYe-uH0LLG0Kq3Wk/images/v2/qr-codes/create/google-maps/provider-google-static.png?fit=max&auto=format&n=GYe-uH0LLG0Kq3Wk&q=85&s=09f53c8b0d3e6deedd71e4d4227aa50f" alt="Google Maps Quick Code form with the Google provider selected" width="1316" height="904" data-path="images/v2/qr-codes/create/google-maps/provider-google-static.png" />
    </Frame>
  </Step>

  <Step title="Search for a place">
    Type into **Search for a place...** and pick a result from the autocomplete dropdown. The map recenters on that location and drops a pin, showing the full formatted address and its latitude/longitude underneath.

    <Frame caption="A location selected on the OpenStreetMap provider, with an interactive draggable pin">
      <img src="https://mintcdn.com/scanova-api/GYe-uH0LLG0Kq3Wk/images/v2/qr-codes/create/google-maps/location-pin-openstreetmap.png?fit=max&auto=format&n=GYe-uH0LLG0Kq3Wk&q=85&s=45d2275f51ad3ecad6a945ef610b7e99" alt="Google Maps Quick Code form on the OpenStreetMap provider showing a pin dropped on Golden Gate Bridge" width="1316" height="904" data-path="images/v2/qr-codes/create/google-maps/location-pin-openstreetmap.png" />
    </Frame>

    A location target is required before you can publish.
  </Step>

  <Step title="Choose Dynamic or Static">
    **QR Code type** defaults to **Dynamic** (editable later, trackable, supports [Advanced settings](/qr-codes/manage/age-restriction)). Switching to **Static** encodes the location directly — it can't be edited or tracked afterward, and it drops the Short URL and Advanced settings sections entirely, since those only exist for Dynamic codes.

    If you keep Dynamic, a **Short URL** section appears where you set a slug (or a [custom domain](/qr-codes/manage/custom-domains), if configured) — required before publishing.
  </Step>

  <Step title="Publish">
    Click **Publish**. A panel opens to confirm or rename the QR Code (it defaults to the location's formatted address), assign a folder or tags, and adjust QR Code design before confirming.

    <Frame caption="Publish confirmation for a Dynamic Google Maps QR Code">
      <img src="https://mintcdn.com/scanova-api/GYe-uH0LLG0Kq3Wk/images/v2/qr-codes/create/google-maps/published-confirmation.png?fit=max&auto=format&n=GYe-uH0LLG0Kq3Wk&q=85&s=2a48f014259bc4aba76d0cb056dcbcef" alt="Published confirmation panel for a Google Maps QR Code, showing the QR Code image, a Live badge, the short URL" width="1316" height="904" data-path="images/v2/qr-codes/create/google-maps/published-confirmation.png" />
    </Frame>
  </Step>
</Steps>

## Creating one via the API

To create a Google Maps QR Code through the API rather than the UI, use category ID `11` (labeled **Google Maps**, slug `map`), with an `info` payload shaped like:

```json theme={null}
{
  "type": "map",
  "data": {
    "provider": "google",
    "latitude": "37.8176155",
    "longitude": "-122.4783123",
    "placeId": "323254185",
    "placeName": "Golden Gate Bridge, Golden Gate Bridge East Sidewalk, San Francisco, California, 94129, United States"
  }
}
```

<Note>
  `data.provider` is confirmed to always be `"google"` in the stored payload, even for a QR Code created against the OpenStreetMap widget — the provider toggle in the UI only changes which map is used to pick the location, not what's saved. `placeId` is sourced from whichever provider you searched with, so its format varies (a numeric OpenStreetMap-style ID in the example above, rather than a typical Google Place ID string).
</Note>

Both `qr_type: "dy"` and `qr_type: "st"` are accepted for this category — Static is a selectable option alongside the Dynamic default. See [Create QR Code](/api-reference/management-api/qr/create) for the full request schema and [Category List](/v1/api-reference/references/category-list) for the complete ID-to-label mapping (Google Maps is listed there as category `11`).

## Related

* [Creating your first QR Code](/getting-started/first-qr-code) — a full walkthrough of the Quick Code flow this type belongs to
* [Quick Code vs. full Page](/qr-codes/create/quick-code-vs-page) — how Google Maps and the other Quick Code types compare to a full landing page
* [Custom domains](/qr-codes/manage/custom-domains) — use your own domain for the Dynamic short URL
* [Folders, tags & bulk operations](/qr-codes/manage/folders-tags-bulk-operations) — organize the QR Code after publishing it