Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tyom/photo-info
Extract geo information from a photo and generate SVG showing the angle of view
https://github.com/tyom/photo-info
geolocation library photo
Last synced: 2 days ago
JSON representation
Extract geo information from a photo and generate SVG showing the angle of view
- Host: GitHub
- URL: https://github.com/tyom/photo-info
- Owner: tyom
- License: mit
- Created: 2024-10-19T16:00:29.000Z (20 days ago)
- Default Branch: main
- Last Pushed: 2024-10-25T19:30:06.000Z (14 days ago)
- Last Synced: 2024-10-29T09:08:57.426Z (10 days ago)
- Topics: geolocation, library, photo
- Language: TypeScript
- Homepage: https://tyom.github.io/photo-info/
- Size: 706 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Photo Info
[](https://www.npmjs.com/package/photo-info)
[](https://github.com/tyom/photo-info/actions/workflows/build.yaml)
This package provides a function to extract useful information from photos, such as geo location, camera make and model,
focal length and angle of view, which could be useful to orient the photo on the map.
## Demo App
Try the [demo app](https://tyom.github.io/photo-info/) with a few geotagged photos. All photos operations are done in the browser.
No data is sent to any server.
## Installation
```bash
npm install photo-info
```
## Usage
```ts
import { getPhotoInfo } from 'photo-info';
const { angleOfView, bearing, position, make, model } =
await getPhotoInfo(file);
```
To get the original EXIF data, set the `includeOriginalTags` parameter to `true`.
```ts
const { originalTags, ...photoInfo } = await getPhotoInfo(file, true);
await getPhotoInfo(file);
```
The `getPhotoInfo` function returns an object with the following properties:
- `make`: the camera make
- `model`: the camera model
- `angleOfView`: the angle of view of the photo in degrees
- `bearing`: the bearing of the photo in degrees
- `gpsPosition`: the position of the photo as a `[Latitude, Longitude, Altitude?]` tuple
- `gpsSpeed`: the speed the camera was moving at `{ value: number, description: 'km/h' }`
- `focalLength`: the focal length of the camera in millimeters
- `focalLengthIn35mm`: the focal length of the camera in 35mm equivalent millimeters
- `width`: the width of the photo in pixels
- `height`: the height of the photo in pixels
- `orientation`: the orientation of the photo (`portrait`, `landscape`, or `square`)
- `frontCamera`: whether the photo was taken with the front camera
- `dateTime`: the date and time the photo was taken in ISO format
- `exposureTime`: the exposure time of the photo in seconds
- `exposureProgram`: the exposure program setting in the camera
- `fNumber`: the f-number (aperture) of the lens
- `lens`: the lens used to take the photo
- `originalTags`: the original EXIF tags of the photo (when the second argument of `getPhotoInfo` is set to `true`)