From 956037cd428c9faae4826bb172a4e566909746e9 Mon Sep 17 00:00:00 2001 From: bijoy Date: Fri, 30 Jun 2023 23:10:43 +0600 Subject: [PATCH] README file added --- README.md | 92 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) diff --git a/README.md b/README.md index 9f74c08..24a032d 100644 --- a/README.md +++ b/README.md @@ -15,3 +15,95 @@ To use this package, add `map_camera_location` as a dependency in your `pubspec. ```yaml dependencies: map_camera_location: ^1.0.0 +``` +### Usage + +Import the package in your Dart file: + +```dart +import 'package:map_camera_location/map_camera_location.dart'; +``` + +## Permissions +Before using the package, make sure to add the necessary location permission to your AndroidManifest.xml file. + +```xml + +``` + +## Usage +The `MapCameraLocation` widget is used to capture images and retrieve location information. It requires a `CameraDescription` object and an optional callback function for receiving the captured image and location data. + +```dart +MapCameraLocation( + camera: yourCameraDescription, + onImageCaptured: yourCallbackFunction, +) +``` + +The `camera` parameter is required and represents the camera to be used for capturing images. You can obtain a `CameraDescription` object using the `camera` package or any other camera plugin. + +The `onImageCaptured` parameter is an optional callback function that will be triggered when an image and location data are captured. The function should have the following signature: + +```dart +void yourCallbackFunction(ImageAndLocationData data) { + // Handle the captured image and location data +} +``` + +The `ImageAndLocationData` object contains the captured image file path and the location information (latitude, longitude, location name, and sublocation). + +The `MapCameraLocation` widget can be placed within your widget tree to display the camera preview and provide buttons or other UI elements for capturing images and updating location information. + +### Example +Here's an example of how to use the `MapCameraLocation` widget: + +```dart +import 'package:flutter/material.dart'; +import 'package:map_camera_location/map_camera_location.dart'; + +void main() { + runApp(MyApp()); +} + +class MyApp extends StatelessWidget { + @override + Widget build(BuildContext context) { + return MaterialApp( + home: Scaffold( + appBar: AppBar( + title: Text('Camera Location Demo'), + ), + body: Center( + child: MapCameraLocation( + camera: yourCameraDescription, + onImageCaptured: yourCallbackFunction, + ), + ), + ), + ); + } + + void yourCallbackFunction(ImageAndLocationData data) { + // Handle the captured image and location data + // For example, save the image to a file or display the location information + } +} +``` +For more information and detailed examples, refer to the package documentation. + +### Issues and Contributions +If you encounter any issues or have suggestions for improvements, please file an issue on the GitHub repository. + +Pull requests are also welcome! If you would like to contribute to this package, feel free to open a pull request with your proposed changes. + +### License +This package is released under the MIT License. See the LICENSE file for more details. + +```vbnet + +Please note that you should replace `yourCameraDescription` and `yourCallbackFunction` with the appropriate values for your specific use case. Also, make sure to update the license and repository links with the correct information for your package. + +Feel free to customize the README file further based on your package's specific features and requirements. + +``` \ No newline at end of file