# Location Select
URL: /docs/native/expo/location-select

Location picker field with device geolocation and reverse geocoding support.

## Overview

`DocyFieldLocationSelect` uses **community native modules** for device-specific location features:

- **`@react-native-community/geolocation`** — Access device GPS to get current coordinates
- **`react-native-geocoding`** — Reverse geocode coordinates to human-readable addresses (requires Google Maps API key)

Without these modules installed, the location picker still works with manual text search and predefined locations — but the "Use Current Location" button will be unavailable.

## Installation

```bash
# Geolocation (for "Use Current Location" feature)
npx expo install @react-native-community/geolocation

# Reverse geocoding (for converting coordinates to addresses)
npm install react-native-geocoding
```

### Google Maps API Key

Reverse geocoding requires a Google Maps Geocoding API key. Pass it as a prop or set the `EXPO_PUBLIC_GOOGLE_MAPS_API_KEY` environment variable:

```tsx

```

## Compatibility

| Module | Expo Go | Dev Client | Bare RN |
|--------|---------|------------|---------|
| `@react-native-community/geolocation` | No | Yes | Yes (auto-linked) |
| `react-native-geocoding` | Yes (JS only) | Yes | Yes |

> **Note:** `@react-native-community/geolocation` requires a **development build** — it does not work in Expo Go. The component handles this gracefully at runtime.

## Usage

```tsx
import { DocyFieldLocationSelect } from '@/components/docyrus-native/form-fields/docy-field-location-select';

<DocyFieldLocationSelect
  label="Office Location"
  allowCurrentLocation
  showCoordinates
  requestLocationPermission={async () => {
    // Your permission handling logic
    return 'granted';
  }}
  onChange={(location) => console.log(location)}
/>
```

## API Reference

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `value` | `LocationInfo` | — | Current location value |
| `onChange` | `(value: LocationInfo) => void` | — | Called when location changes |
| `placeholder` | `string` | `'Select location'` | Placeholder text |
| `allowCurrentLocation` | `boolean` | `true` | Show "Use Current Location" button |
| `showCoordinates` | `boolean` | `true` | Show coordinates under location items |
| `predefinedLocations` | `LocationInfo[]` | Popular cities | Custom location list |
| `requestLocationPermission` | `() => Promise<'granted' \| 'denied'>` | — | Permission request callback |
| `googleMapsApiKey` | `string` | `EXPO_PUBLIC_GOOGLE_MAPS_API_KEY` | Google Maps API key for geocoding |

### LocationInfo Type

| Field | Type | Description |
|-------|------|-------------|
| `name` | `string` | Display name |
| `address` | `string?` | Full address |
| `coordinates` | `{ latitude: number; longitude: number }?` | GPS coordinates |
| `country` | `string?` | Country name |
| `city` | `string?` | City name |
| `region` | `string?` | Region/state |
| `postalCode` | `string?` | Postal code |
| `type` | `'current' \| 'saved' \| 'search'?` | Location source |