---
schema_version: "1"
id: bb15e65e242def0369047e76605972cf72ca6f75351bf076ec08fd7c4fa4eff4
title: Input Location
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/lightning-base-components/lightning-design-system/guides/lwc/components/lightning/inputLocation/lightning-input-location.md
canonical_url: https://developer.salesforce.com/docs/platform/lightning-component-reference/guide/lightning-input-location.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 40a86727b9fba678b6951ceecf50512c88f057bebac130362b98e7c7fd36596b
products:
  - Lightning Component Reference
---

# Input Location

**`lightning-input-location`**

Represents a geolocation compound field that accepts a latitude and longitude value.

**For Use In**

Lightning Experience, Experience Builder Sites, Salesforce Mobile App, Lightning Out (Beta), Standalone Lightning App, Mobile Offline

::::::tabset{tabs='["Example", "Develop", "Specifications"]'}

:::::tab

::component-playground{component="inputLocation" model="lwc" namespace="lightning"}


:::::

:::::tab

A `lightning-input-location` component represents a geolocation compound field
that accepts user input for a latitude and longitude value. Latitude and
longitude are geographic coordinates specified in decimal degrees. The
geolocation compound field allows you to identify locations by their latitude
and longitude. The latitude field accepts values within -90 and 90, and the
longitude field accepts values within -180 and 180. An error message is
displayed when you enter a value outside of the accepted range.

Here are a few examples of latitudes: -30, 45, 37.12345678, -10.0. Values such
as 90.5 or -90.5 are not valid latitudes.

Here are a few examples of
longitudes: -100, -120.9762, 115.84. Values such as 180.5 or -180.5 are not
valid longitudes.

This example displays a geolocation compound field with a latitude of
37.7938460 and a longitude of -122.3948370.

<!-- prettier-ignore-start -->
```html
<template>
    <lightning-input-location
        label="My Coordinates"
        latitude="37.7938460"
        longitude="-122.3948370"
    >
    </lightning-input-location>
</template>
```
<!-- prettier-ignore-end -->

## Design

`lightning-input-field` implements the form element blueprint in the Salesforce Lightning Design System (SLDS). The input fields adapt to SLDS 1 or SLDS 2 styling based on the org's theme or the container app that you use.

|                | SLDS 1                                                                                | SLDS 2                                                                                                          |
| :------------- | :------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------- |
| **Design**     | [Form Element](https://v1.lightningdesignsystem.com/components/form-element/)         | [Form Element](https://www.lightningdesignsystem.com/components/form-element/)                                  |
| **For Use In** | Lightning Experience, Experience Builder sites, Salesforce mobile app, Mobile Offline | [Lightning Experience](https://help.salesforce.com/s/articleView?id=xcloud.customize_ui_enhancedlex.htm&type=5) |

## Input Validation

Client-side input validation is available for this component. You can require
the user to make a selection by including the `required` attribute. An error message
is automatically displayed when a user interacts with the field but leaves it empty.

To check the validity states of an input, use the `validity` attribute, which
is based on the `ValidityState` object. You can access the validity states in
your JavaScript. This `validity` attribute returns an object with
`boolean` properties. For more information, see the
[`lightning-input`](/docs/platform/lightning-component-reference/guide/lightning-input.html) documentation.

## Custom Events

**`change`**

The event fired when a value is changed in the `lightning-input-location` component.

The `change` event returns the following parameters.

| Parameter | Type   | Description                    |
| --------- | ------ | ------------------------------ |
| latitude  | string | The latitude of the location.  |
| longitude | string | The longitude of the location. |

The `change` event properties are as follows.

| Property   | Value | Description                                                                                               |
| ---------- | ----- | --------------------------------------------------------------------------------------------------------- |
| bubbles    | true  | This event bubbles up through the DOM.                                                                    |
| cancelable | false | This event has no default behavior that can be canceled. You can't call `preventDefault()` on this event. |
| composed   | true  | This event propagates outside of the component in which it was dispatched.                                |

## See Also

[_Object Reference for the Salesforce Platform_: Field Types](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/field_types.htm)


:::::

:::::tab
::component-specification{component="inputLocation" model="lwc" namespace="lightning"}

:::::

::::::