# Google maps locator

## The Google maps Locator

Shows one icon (marker) on a Google Map, based on a latitude and longitude value. This widget does not provide travel information and does not support multiple markers, it simply displays one location on a map. For travel information you can use the 'Google Maps - Directions' widget. To display multiple markers you can use the 'Google Maps - Markermap' widget. Demonstrations of both widgets are coming soon.

{% hint style="info" %}
This widget requires a API key to function, you can find API keys more about API keys on: [this page](https://developers.google.com/maps/documentation/javascript/get-api-key). 
{% endhint %}

<div data-full-width="true"><figure><img src="/files/YmlosaIgtv9UhjfSkBxQ" alt=""><figcaption><p>Don't forget to add an icon file to the marker property! (not shown)</p></figcaption></figure></div>

## Properties

### General

<table><thead><tr><th width="163.33333333333331">Properties</th><th width="191">Datatype</th><th>Description</th></tr></thead><tbody><tr><td>Latitude</td><td>number, datafield</td><td>The latitude of a location: a coordinate that specifies the north–south position of the location on the map.</td></tr><tr><td>Longitude</td><td>number, datafield</td><td>The longitude of a location: a coordinate that specifies the east-west position of the location on the map.</td></tr><tr><td>Api Key</td><td>Text, expression</td><td>The Google API key (required). You can find more about the google maps API's here: <a href="https://developers.google.com/maps/documentation/javascript/get-api-key">Link</a></td></tr></tbody></table>

### Behavior

<table><thead><tr><th width="167.33333333333331">Properties</th><th width="193">Datatype</th><th>Description</th></tr></thead><tbody><tr><td>Auto locate</td><td>dropdown, boolean</td><td>When set to 'Yes': try to pinpoint the (GPS) location of the user when either the property 'Latitude ' or 'Longitude ' is unknown. Otherwise a default location is used (Amsterdam).</td></tr><tr><td>Map type</td><td>text, expression</td><td><p></p><p>Google Maps supports the following map types:</p><ul><li>"roadmap" displays the default road map view. This is the default map type.</li><li>"satellite" displays Google Earth satellite images</li><li>"hybrid" displays a mixture of normal and satellite views</li><li>"terrain" displays a physical map based on terrain information.</li></ul></td></tr></tbody></table>

### Appearance

<table><thead><tr><th width="163.33333333333331">Properties</th><th width="228">Datatype</th><th>Description</th></tr></thead><tbody><tr><td>Zoom</td><td>dropdown, boolean</td><td>Set the default zoom level of the map.</td></tr><tr><td>Responsive</td><td>text, expression</td><td><em>When set to 'No':</em> allows you to provide the width of the map in pixels. The width remains the same on smaller screen sizes. <br><em>When set to 'Yes':</em> the width of the map is as large as possible and changes on smaller screen sizes.</td></tr><tr><td>Width</td><td>number</td><td>Set the width of the map in pixels. Only visible when 'Responsive &#x3C;dropdown, boolean>' is set to No. A large width may cause the map to be not entirely visible on small screen sizes.</td></tr><tr><td>Height</td><td>number</td><td>Set the height of the map in pixels. The height of the map remains the same on all devices and screen sizes.</td></tr><tr><td>Marker icon</td><td>Image</td><td>Display an image instead of using the default red marker icon.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wem.io/platform/wemtipsandtricks/widgets/advanced-input/google-maps-locator.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.