Camera With GPS Flutter Plugin

A Flutter plugin for capturing photos with embedded GPS metadata. It provides a full-screen camera experience and automatically tags photos with the device's location (latitude and longitude).

Overview

CameraWithGps offers:

Full-screen camera UI: For high-resolution photo capture.
Automatic GPS metadata: Embeds latitude and longitude into photos.
Cross-platform support: Works on both iOS and Android.
Lightweight & efficient: Easy integration into your Flutter projects.

Installation

Add the dependency to your pubspec.yaml file:
```
dependencies:
  camera_with_gps: ^1.0.0
```
Install the package by running:
```
flutter pub get
```

Platform Setup

Android

Permissions: Add the following to your AndroidManifest.xml:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.location.gps" />

Minimum SDK: Ensure your android/app/build.gradle includes:

android {
  defaultConfig {
    minSdkVersion 21 // Ensure minSdkVersion is 21 or higher
    ...
  }
}

Runtime Permissions: Make sure your app requests location permissions during runtime as needed.

iOS

Info.plist: Add these keys for camera and location usage:

<key>NSCameraUsageDescription</key>
<string>This app requires camera access to take photos.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>This app requires location access to add GPS data to photos.</string>

Image I/O Framework: Ensure it is included in your project.

Usage

Importing the Plugin

Include the package in your Dart file:

import 'package:camera_with_gps/camera_with_gps.dart';

Initializing the Plugin

Assign the plugin’s navigatorKey to your app’s Navigator:

void main() {
  runApp(MaterialApp(
    navigatorKey: CameraWithGps.navigatorKey,
    home: const MyApp(),
  ));
}

Opening the Camera

Launch the camera UI and capture a photo:

Future<void> openCamera() async {
  try {
    final photoPath = await CameraWithGps.openCamera();
    if (photoPath != null) {
      print('Photo saved at: $photoPath');
    }
  } catch (e) {
    print('Failed to open camera: $e');
  }
}

Embedding GPS Metadata

To manually add GPS metadata, call:

final success = await CameraWithGps.addGps(
  path: '/path/to/photo.jpg',
  latitude: 37.4219983,
  longitude: -122.084,
);
print(success ? "GPS metadata added!" : "Failed to add GPS metadata.");

Structure

The plugin consists of the following components:

CameraWithGps: Main class handling camera launching and EXIF editing.
CameraPreviewPage: Provides the full-screen UI for capturing photos.
CameraWithGpsPlugin (Kotlin): Manages Android EXIF metadata and native communication.
CameraWithGpsPlugin (Swift): Manages iOS EXIF metadata and native communication.

API Reference

Method	Description
`openCamera()`	Opens the camera interface and returns the file path of the captured photo.
`addGps(String, double, double)`	Embeds GPS data (latitude and longitude) into an image file. Returns success/failure.

Example

Below is a complete example of using the plugin in a Flutter application:

import 'package:camera_with_gps/camera_with_gps.dart';
import 'package:flutter/material.dart';

void main() {
  runApp(MaterialApp(
    navigatorKey: CameraWithGps.navigatorKey,
    home: const MyApp(),
  ));
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  Future<void> _capturePhoto() async {
    try {
      final path = await CameraWithGps.openCamera();
      if (path != null) {
        print('Photo captured at: $path');
      } else {
        print('Capture canceled or failed.');
      }
    } catch (e) {
      print('Error: $e');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Camera With GPS Example')),
      body: Center(
        child: ElevatedButton(
          onPressed: _capturePhoto,
          child: const Text('Capture Photo'),
        ),
      ),
    );
  }
}

Cross-platform Implementation

Android

GPS Metadata Handling: Uses Android's ExifInterface from Jetpack.
Key File: CameraWithGpsPlugin.kt handles native communication and metadata embedding.

iOS

GPS Metadata Handling: Uses the Image I/O framework.
Key File: CameraWithGpsPlugin.swift handles native communication and metadata embedding.

Contributing

Contributions are welcome! To contribute:

Fork the repository.
Create a new branch for your feature or bug fix.
Make your enhancements or corrections.
Submit a pull request.

License

Released under the MIT License. Feel free to use, modify, and distribute.

ChangelogBelow is the updated README file with a new "Important" section at the top that emphasizes the mandatory permissions for both Android and iOS:

# Camera With GPS Flutter Plugin

A Flutter plugin for capturing photos with embedded GPS metadata. It provides a full-screen camera experience and automatically tags photos with the device's location (latitude and longitude).

> **Important: Mandatory Permissions**  
> Before using this plugin, you **must** configure the required permissions for both Android and iOS. Without proper permissions in your project's configuration files (e.g. AndroidManifest.xml for Android and Info.plist for iOS), the plugin will not function correctly.

---

## Overview

**CameraWithGps** offers:

- **Full-screen camera UI:** For high-resolution photo capture.
- **Automatic GPS metadata:** Embeds latitude and longitude into photos.
- **Cross-platform support:** Works on both iOS and Android.
- **Lightweight & efficient:** Easy integration into your Flutter projects.

---

## Installation

1. **Add the dependency** to your `pubspec.yaml` file:

   ```yaml
   dependencies:
     camera_with_gps: ^1.0.0

Install the package by running:
```
flutter pub get
```

Platform Setup

Android

Permissions: Add the following to your AndroidManifest.xml:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.location.gps" />

Minimum SDK: Ensure your android/app/build.gradle includes:

android {
  defaultConfig {
    minSdkVersion 21 // Ensure minSdkVersion is 21 or higher
    ...
  }
}

Runtime Permissions: Make sure your app requests location permissions during runtime as needed.

iOS

Info.plist: Add these keys for camera and location usage:

<key>NSCameraUsageDescription</key>
<string>This app requires camera access to take photos.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>This app requires location access to add GPS data to photos.</string>

Image I/O Framework: Ensure it is included in your project.

Usage

Importing the Plugin

Include the package in your Dart file:

import 'package:camera_with_gps/camera_with_gps.dart';

Initializing the Plugin

Assign the plugin’s navigatorKey to your app’s Navigator if you are using it. Note: The latest version of the plugin now supports passing a BuildContext directly to methods, so using a global navigator key is optional.

void main() {
  runApp(MaterialApp(
    navigatorKey: CameraWithGps.navigatorKey,
    home: const MyApp(),
  ));
}

Opening the Camera

Launch the camera UI and capture a photo:

Future<void> openCamera() async {
  try {
    // Pass the BuildContext to openCamera
    final photoPath = await CameraWithGps.openCamera(context);
    if (photoPath != null) {
      print('Photo saved at: $photoPath');
    }
  } catch (e) {
    print('Failed to open camera: $e');
  }
}

Embedding GPS Metadata

To manually add GPS metadata, call:

final success = await CameraWithGps.addGps(
  path: '/path/to/photo.jpg',
  latitude: 37.4219983,
  longitude: -122.084,
);
print(success ? "GPS metadata added!" : "Failed to add GPS metadata.");

Structure

The plugin consists of the following components:

CameraWithGps: Main class handling camera launching and EXIF editing.
CameraPreviewPage: Provides the full-screen UI for capturing photos.
CameraWithGpsPlugin (Kotlin): Manages Android EXIF metadata and native communication.
CameraWithGpsPlugin (Swift): Manages iOS EXIF metadata and native communication.

API Reference

Method	Description
`openCamera(BuildContext)`	Opens the camera interface and returns the file path of the captured photo.
`addGps(String, double, double)`	Embeds GPS data (latitude and longitude) into an image file. Returns success/failure.

Example

Below is a complete example of using the plugin in a Flutter application:

import 'package:camera_with_gps/camera_with_gps.dart';
import 'package:flutter/material.dart';

void main() {
  runApp(MaterialApp(
    navigatorKey: CameraWithGps.navigatorKey,
    home: const MyApp(),
  ));
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  Future<void> _capturePhoto(BuildContext context) async {
    try {
      final path = await CameraWithGps.openCamera(context);
      if (path != null) {
        print('Photo captured at: $path');
      } else {
        print('Capture canceled or failed.');
      }
    } catch (e) {
      print('Error: $e');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Camera With GPS Example')),
      body: Center(
        child: ElevatedButton(
          onPressed: () => _capturePhoto(context),
          child: const Text('Capture Photo'),
        ),
      ),
    );
  }
}

Cross-platform Implementation

Android

GPS Metadata Handling: Uses Android's ExifInterface from Jetpack.
Key File: CameraWithGpsPlugin.kt handles native communication and metadata embedding.

iOS

GPS Metadata Handling: Uses the Image I/O framework.
Key File: CameraWithGpsPlugin.swift handles native communication and metadata embedding.

Contributing

Contributions are welcome! To contribute:

Fork the repository.
Create a new branch for your feature or bug fix.
Make your enhancements or corrections.
Submit a pull request.

License

Released under the MIT License. Feel free to use, modify, and distribute.

Changelog

v.1.0

Initial release.
Full-screen camera integration for Flutter.
GPS metadata embedding for iOS and Android.

v.1.1

Update openCamera to require BuildContext for navigation
Replaced navigatorKey with a BuildContext parameter in openCamera for improved navigation handling.

Maintainers

Developed and maintained by Ruslan Madzhara.
For queries or support, please contact us.

This plugin is available on pub.dev for easy access and installation.

Camera With GPS Flutter Plugin

Overview

Installation

Platform Setup

Android

iOS

Usage

Importing the Plugin

Initializing the Plugin

Opening the Camera

Embedding GPS Metadata

Structure

API Reference

Example

Cross-platform Implementation

Android

iOS

Contributing

License

ChangelogBelow is the updated README file with a new "Important" section at the top that emphasizes the mandatory permissions for both Android and iOS:

Platform Setup

Android

iOS

Usage

Importing the Plugin

Initializing the Plugin

Opening the Camera

Embedding GPS Metadata

Structure

API Reference

Example

Cross-platform Implementation

Android

iOS

Contributing

License

Changelog

v.1.0

v.1.1

Maintainers

Libraries

camera_with_gps package