https://github.com/stuomas/bridge-map-view
A Google Maps based geotagging extension for Adobe Bridge
https://github.com/stuomas/bridge-map-view
adobe-bridge adobe-extensions geotagging mapview
Last synced: 12 months ago
JSON representation
A Google Maps based geotagging extension for Adobe Bridge
- Host: GitHub
- URL: https://github.com/stuomas/bridge-map-view
- Owner: stuomas
- License: gpl-3.0
- Created: 2021-07-08T07:31:04.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2022-10-30T11:50:12.000Z (over 3 years ago)
- Last Synced: 2025-03-26T01:51:07.156Z (about 1 year ago)
- Topics: adobe-bridge, adobe-extensions, geotagging, mapview
- Language: JavaScript
- Homepage:
- Size: 85.9 KB
- Stars: 8
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Adobe Bridge Map View Extension
A Google Maps based extension for Adobe Bridge for geotagging photos and showing their location on an interactive map.
## Prerequisites
You need to generate your personal Google Cloud API key to use the extension. You need to set billing information etc., but worry not, the Google Maps Platform gives generous monthly [free quota](https://developers.google.com/maps/billing-and-pricing/billing#monthly-credit), so you will practically never have to pay real money to use this extension, if you don't share your API key with others. (small print: nevertheless l take no responsibility if you somehow manage to exceed your free quota. Set a usage limit if worried).
1. [Create a Google Cloud project](https://developers.google.com/maps/documentation/javascript/cloud-setup)
- [Enable](https://developers.google.com/maps/documentation/javascript/cloud-setup#enabling-apis) `Maps JavaScript API` and `Places API` for the project
2. [Generate an API key](https://developers.google.com/maps/documentation/javascript/get-api-key)
- Copy the generated key
3. Since this extension is not packaged or signed, it can only be used with [debug mode](https://github.com/Adobe-CEP/CEP-Resources/blob/master/CEP_10.x/Documentation/CEP%2010.0%20HTML%20Extension%20Cookbook.md#debugging-unsigned-extensions) enabled
## Installation
1. Clone the repository or download as a zip
2. Copy the `MapViewCEP` to any of the [extension folders](https://github.com/Adobe-CEP/CEP-Resources/blob/master/CEP_10.x/Documentation/CEP%2010.0%20HTML%20Extension%20Cookbook.md#extension-folders)
- It has been reported that only the per-user folders work, so I suggest trying that first. E.g. for Windows `C:\Users\\AppData\Roaming\Adobe\CEP\extensions`
3. Copy the `nativeEventForwarder.jsx` script to the Startup Scripts folder of Bridge. You can find the path from Edit → Preferences → Startup Scripts → Reveal My Startup Scripts
4. (Re)start Bridge
5. Open extension from Window → Extensions → Map
## Usage
#### Save API key
When you first launch the extension, you will be asked to enter your API key. If it works, the map will launch and the key will be saved in the extension's userdata folder. If it does not work (wrong key, insufficient permissions for the key), the API key will be asked again.
#### Geotagging
Click anywhere on the map to set a marker, and click `Save location to EXIF`. The marker location will be saved to the EXIF metadata (`GPSLatitude` and `GPSLongitude`) of all selected items that support EXIF metadata, in degrees and decimal minutes format `(DDD,MM.mmmmmmk)`.
#### Color themes
Map color themes can be changed in `MapViewCEP/client/mapStyles.js`. There are four styles, one for every Bridge's global interface theme. You can make your own styles with online tools like https://mapstyle.withgoogle.com/ and just replace any of the 4 style arrays with a new one. For example, if you use the darkest available Bridge interface, modify the `mapStyleDarkest` array.
## Screenshots
## Development
Tested only on Bridge 2021/2022/2023 for Windows. If you have bugs to report or features to request, please do! Pull requests are also welcome.
- - - -
