README

1. Features

PHP-PhotoGps is a simple library to get GPS data from a photo.

This library reads EXIF data of a jpeg file,

and can convert latitude/longitude into sexagesimal(English/Japanese) or decimal formats,

converts directions into degree with arrow images ,

converts speeds, date stamps and time stamps into human-readable strings.

Remote files (via http: or https:) are supported.

Supported Exif Versions:

3.0
2.32
2.31
2.3
2.21
2.2
2.1

3. Requirements

PHP 8.1 or later
GD library enabled

check with commands:
```
(php -m; php -i) | grep gd
```
Composer

4. Installation

composer require macocci7/php-photo-gps

5. Usage

5.1. Usage: Basic
5.2. Usage: Format Configuration
5.3. Usage: Photo List with Checking Geo Data
5.4. Usage: Read All GPS Tags
5.5. Usage: GPS Attribute Information

5.1. Usage: Basic

5.1.1. PHP
5.1.2. Output
5.1.3. Details

5.1.1. PHP

BasicUsage.php

<?php

require_once __DIR__ . '/../vendor/autoload.php';

use Macocci7\PhpPhotoGps\PhotoGps;

$filename = 'img/with_gps.jpg';    // includes GPS tags
$pg = new PhotoGps($filename);

echo "[" . $filename . "]--------------------\n";

// Latitude in sexagesimal format
echo "Latitude: " . $pg->latitudeS() . "\n";
echo "緯度: " . $pg->lang('ja')->latitudeS() . "\n";

// Longitude in sexagesimal format
echo "Longitude: " . $pg->lang('eng')->longitudeS() . "\n";
echo "経度: " . $pg->lang('ja')->longitudeS() . "\n";

// Altitude as strings
echo "Altitude: " . $pg->lang('eng')->altitudeS() . "\n";
echo "高度: " . $pg->lang('ja')->altitudeS() . "\n";

// Coord in decimal format ('S' and 'W' results in negative value.)
echo "Coord: " . $pg->latitudeD() . ", " . $pg->longitudeD() . "\n";

5.1.2. Output

BasicUsage.txt

[img/with_gps.jpg]--------------------
Latitude: 37°3'26.2"N
緯度: 北緯37度3分26.2秒
Longitude: 140°53'32.8"E
経度: 東経140度53分32.8秒
Altitude: (Above Ellipsoidal Surface) 13.00 m
高度: （正値楕円体高） 13.00 メートル
Coord: 37.057274166667, 140.89244166667

5.1.3. Details

Import autoloader: require_once __DIR__ . '/../vendor/autoload.php'
use declaration: use Macocci7\PhpPhotoGps\PhotoGps;
Instantiation: new PhotoGps() or new PhotoGps($path)
- Note: If HTTP or HTTPS url is specified as $path, download directory will be created in current directory, and the image will be downloaded in it.
Language: eng as default.
- Get Current: lang()
- Set as English: lang('eng')
- Set as Japanese: lang('ja')
Language Names are defined in config/PhotoGps.neon.
Latitude:
- Decimal: latitudeD()
- Sexagesimal: latitudeS()
Longitude:
- Decimal: longitudeD()
- Sexagesimal: longitudeS()
Altitude:
- Decimal: altitude()
- Strings with prefix & unit: altitudeS()

5.2. Usage: Format Configuration

5.2.1. Geo Data Format
5.2.2. Direction Data Format
5.2.3. Speed Data Format
5.2.4. Datestamp Data Fromat
5.2.5. Timestamp Data Format

5.2.1. Geo Data Format

for latitudeS() and longitudeS().

5.2.1.1. PHP
5.2.1.2. Output
5.2.1.3. Details

5.2.1.1. PHP

ConfigFormat.php

<?php

require_once __DIR__ . '/../vendor/autoload.php';

use Macocci7\PhpPhotoGps\PhotoGps;

$filename = 'img/with_gps.jpg';    // includes GPS tags
$pg = new PhotoGps($filename);

echo "[" . $filename . "]--------------------\n";

// Format: default
echo "Current format [eng]: " . $pg->lang('eng')->format() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->format() . "\n\n";

// Latitude in sexagesimal format
echo "Latitude: " . $pg->lang('eng')->latitudeS() . "\n";
echo "緯度: " . $pg->lang('ja')->latitudeS() . "\n";

// Longitude in sexagesimal format
echo "Longitude: " . $pg->lang('eng')->longitudeS() . "\n";
echo "経度: " . $pg->lang('ja')->longitudeS() . "\n\n";

echo "[Chang format:eng]---------------------------------\n";

// Configure format
$pg->lang('eng')->format('{ref:u}: {seconds:v}{seconds:u}, {minutes:v}{minutes:u}, {degrees:v}{degrees:u}');

// Current format
echo "Current format [eng]: " . $pg->lang('eng')->format() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->format() . "\n\n";

// Latitude in sexagesimal format
echo "Latitude: " . $pg->lang('eng')->latitudeS() . "\n";
echo "緯度: " . $pg->lang('ja')->latitudeS() . "\n";

// Longitude in sexagesimal format
echo "Longitude: " . $pg->lang('eng')->longitudeS() . "\n";
echo "経度: " . $pg->lang('ja')->longitudeS() . "\n\n";

echo "[Change format:ja]---------------------------------\n";

// Configure format
$pg->lang('ja')->format('{seconds:v}{seconds:u}, {minutes:v}{minutes:u}, {degrees:v}{degrees:u} ({ref:u})');

// Current format
echo "Current format [eng]: " . $pg->lang('eng')->format() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->format() . "\n\n";

// Latitude in sexagesimal format
echo "Latitude: " . $pg->lang('eng')->latitudeS() . "\n";
echo "緯度: " . $pg->lang('ja')->latitudeS() . "\n";

// Longitude in sexagesimal format
echo "Longitude: " . $pg->lang('eng')->longitudeS() . "\n";
echo "経度: " . $pg->lang('ja')->longitudeS() . "\n\n";

echo "[Reset format:ja]---------------------------------\n";

// Reset format
$pg->lang('ja')->resetFormat();

// Current format
echo "Current format [eng]: " . $pg->lang('eng')->format() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->format() . "\n\n";

// Latitude in sexagesimal format
echo "Latitude: " . $pg->lang('eng')->latitudeS() . "\n";
echo "緯度: " . $pg->lang('ja')->latitudeS() . "\n";

// Longitude in sexagesimal format
echo "Longitude: " . $pg->lang('eng')->longitudeS() . "\n";
echo "経度: " . $pg->lang('ja')->longitudeS() . "\n\n";

5.2.1.2. Output

ConfigFormat.txt

[img/with_gps.jpg]--------------------
Current format [eng]: {degrees:v}{degrees:u}{minutes:v}{minutes:u}{seconds:v}{seconds:u}{ref:u}
Current format [ja]: {ref:u}{degrees:v}{degrees:u}{minutes:v}{minutes:u}{seconds:v}{seconds:u}

Latitude: 37°3'26.2"N
緯度: 北緯37度3分26.2秒
Longitude: 140°53'32.8"E
経度: 東経140度53分32.8秒

[Chang format:eng]---------------------------------
Current format [eng]: {ref:u}: {seconds:v}{seconds:u}, {minutes:v}{minutes:u}, {degrees:v}{degrees:u}
Current format [ja]: {ref:u}{degrees:v}{degrees:u}{minutes:v}{minutes:u}{seconds:v}{seconds:u}

Latitude: N: 26.2", 3', 37°
緯度: 北緯37度3分26.2秒
Longitude: E: 32.8", 53', 140°
経度: 東経140度53分32.8秒

[Change format:ja]---------------------------------
Current format [eng]: {ref:u}: {seconds:v}{seconds:u}, {minutes:v}{minutes:u}, {degrees:v}{degrees:u}
Current format [ja]: {seconds:v}{seconds:u}, {minutes:v}{minutes:u}, {degrees:v}{degrees:u} ({ref:u})

Latitude: N: 26.2", 3', 37°
緯度: 26.2秒, 3分, 37度 (北緯)
Longitude: E: 32.8", 53', 140°
経度: 32.8秒, 53分, 140度 (東経)

[Reset format:ja]---------------------------------
Current format [eng]: {ref:u}: {seconds:v}{seconds:u}, {minutes:v}{minutes:u}, {degrees:v}{degrees:u}
Current format [ja]: {ref:u}{degrees:v}{degrees:u}{minutes:v}{minutes:u}{seconds:v}{seconds:u}

Latitude: N: 26.2", 3', 37°
緯度: 北緯37度3分26.2秒
Longitude: E: 32.8", 53', 140°
経度: 東経140度53分32.8秒

5.2.1.3. Details

Get Format: format()
Set Format: format($format)
Reset Format: resetFormat()
Default Format: {ref:u}{degrees:v}{degrees:u}{minutes:v}{minutes:u}{seconds:v}{seconds:u}

Format-Tags:

Item	Tag	`eng`	`ja`
Ref	{ref:u}	N	北緯
Degrees Value	{degrees:v}	12	12
Degrees Unit	{degrees:u}	°	度
Minutes Value	{minutes:v}	34	34
Minutes Unit	{minutes:u}	'	分
Seconds Value	{seconds:v}	56	56
Seconds Unit	{seconds:u}	"	秒

latitudeS() and longitudeS() use common format.

5.2.2. Direction Data Format

for directionS(), destBearingS() and TrackS().

5.2.2.1. PHP
5.2.2.2. Output
5.2.2.3. Details

5.2.2.1. PHP

ConfigDirectionFormat.php

<?php

require_once __DIR__ . '/../vendor/autoload.php';

use Macocci7\PhpPhotoGps\PhotoGps;

$filename = 'img/with_gps.jpg';
$pg = new PhotoGps($filename);

echo "[" . $filename . "]--------------------\n";

// Format: default
echo "Current format [eng]: " . $pg->lang('eng')->directionFormat() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->directionFormat() . "\n\n";

// Image Direction: default format
echo "Image Direction [eng]: " . $pg->lang('eng')->directionS() . "\n";
echo "Image Direction [ja]: " . $pg->lang('ja')->directionS() . "\n\n";

// Configure Format: eng
$pg->lang('eng')->directionFormat('{degrees:v}{degrees:u}({ref})');

// Current Format
echo "Current format [eng]: " . $pg->lang('eng')->directionFormat() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->directionFormat() . "\n\n";

// Image Direction: Current Format
echo "Image Direction [eng]: " . $pg->lang('eng')->directionS() . "\n";
echo "Image Direction [ja]: " . $pg->lang('ja')->directionS() . "\n\n";

// Configure Format: ja
$pg->lang('ja')->directionFormat('{degrees:v}{degrees:u}');

// Reset Format: eng
$pg->lang('eng')->resetDirectionFormat();

// Current Format
echo "Current format [eng]: " . $pg->lang('eng')->directionFormat() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->directionFormat() . "\n\n";

// Image Direction: Current Format
echo "Image Direction [eng]: " . $pg->lang('eng')->directionS() . "\n";
echo "Image Direction [ja]: " . $pg->lang('ja')->directionS() . "\n\n";

5.2.2.2. Output

ConfigDirectionFormat.txt

[img/with_gps.jpg]--------------------
Current format [eng]: {ref} {degrees:v}{degrees:u}
Current format [ja]: {ref} {degrees:v}{degrees:u}

Image Direction [eng]: T 306.25°
Image Direction [ja]: 真北 306.25度

Current format [eng]: {degrees:v}{degrees:u}({ref})
Current format [ja]: {ref} {degrees:v}{degrees:u}

Image Direction [eng]: 306.25°(T)
Image Direction [ja]: 真北 306.25度

Current format [eng]: {ref} {degrees:v}{degrees:u}
Current format [ja]: {degrees:v}{degrees:u}

Image Direction [eng]: T 306.25°
Image Direction [ja]: 306.25度

5.2.2.3. Details

Get Format: directionFormat()
Set Format: directionFormat($format)
Reset Format: resetDirectionFormat()
Default Format: {ref} {degrees:v}{degrees:u}
Format-Tags:

Item Tag eng ja

Ref {ref:u} T 真北

Degrees Value {degrees:v} 12.34 12.34

Degrees Unit {degrees:u} ° 度
directionS(), destBearingS() and TrackS() use common format.

Item	Tag	`eng`	`ja`
Ref	{ref:u}	T	真北
Degrees Value	{degrees:v}	12.34	12.34
Degrees Unit	{degrees:u}	°	度

5.2.3. Speed Data Format

for speedS()

5.2.3.1. PHP
5.2.3.2. Output
5.2.3.3. Details

5.2.3.1. PHP

ConfigSpeedFormat.php

<?php

require_once __DIR__ . '/../vendor/autoload.php';

use Macocci7\PhpPhotoGps\PhotoGps;

$filename = 'img/with_gps.jpg';
$pg = new PhotoGps($filename);

echo "[" . $filename . "]--------------------\n";

// Format: default
echo "Current format [eng]: " . $pg->lang('eng')->speedFormat() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->speedFormat() . "\n\n";

// Speed: default format
echo "Speed [eng]: " . $pg->lang('eng')->speedS() . "\n";
echo "Speed [ja]: " . $pg->lang('ja')->speedS() . "\n\n";

// Configure Format: eng
$pg->lang('eng')->speedFormat('{speed:v}({speed:u})');

// Current Format
echo "Current format [eng]: " . $pg->lang('eng')->speedFormat() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->speedFormat() . "\n\n";

// Speed: Current Format
echo "Speed [eng]: " . $pg->lang('eng')->speedS() . "\n";
echo "Speed [ja]: " . $pg->lang('ja')->speedS() . "\n\n";

// Configure Format: ja
$pg->lang('ja')->speedFormat('時速{speed:v}マイル');

// Reset Format: eng
$pg->lang('eng')->resetSpeedFormat();

// Current Format
echo "Current format [eng]: " . $pg->lang('eng')->speedFormat() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->speedFormat() . "\n\n";

// Speed: Current Format
echo "Speed [eng]: " . $pg->lang('eng')->speedS() . "\n";
echo "Speed [ja]: " . $pg->lang('ja')->speedS() . "\n\n";

5.2.3.2. Output

ConfigSpeedFormat.txt

[img/with_gps.jpg]--------------------
Current format [eng]: {speed:v}{speed:u}
Current format [ja]: {speed:v}{speed:u}

Speed [eng]: 1.60mph
Speed [ja]: 1.60マイル／時

Current format [eng]: {speed:v}({speed:u})
Current format [ja]: {speed:v}{speed:u}

Speed [eng]: 1.60(mph)
Speed [ja]: 1.60マイル／時

Current format [eng]: {speed:v}{speed:u}
Current format [ja]: 時速{speed:v}マイル

Speed [eng]: 1.60mph
Speed [ja]: 時速1.60マイル

5.2.3.3. Details

Get Format: speedFormat()
Set Format: speedFormat($format)
Reset Format: resetSpeedFormat()
Default Format: {speed:v}{speed:u}
Format-Tags:

Item Tag eng ja

Speed Value {speed:v} 12.34 12.34

Speed Unit {speed:u} km/h キロメートル／時

Item	Tag	`eng`	`ja`
Speed Value	{speed:v}	12.34	12.34
Speed Unit	{speed:u}	km/h	キロメートル／時

5.2.4. Datestamp Data Format

for datestamp()

5.2.4.1. PHP
5.2.4.2. Output
5.2.4.3. Details

5.2.4.1. PHP

ConfigDatestampFormat.php

<?php

require_once __DIR__ . '/../vendor/autoload.php';

use Macocci7\PhpPhotoGps\PhotoGps;

$filename = 'img/with_gps.jpg';
$pg = new PhotoGps($filename);

echo "[" . $filename . "]--------------------\n";

// Format: default
echo "Current format [eng]: " . $pg->lang('eng')->datestampFormat() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->datestampFormat() . "\n\n";

// Datestamp: default format
echo "Datestamp [eng]: " . $pg->lang('eng')->datestamp() . "\n";
echo "Datestamp [ja]: " . $pg->lang('ja')->datestamp() . "\n\n";

// Configure Format: eng
$pg->lang('eng')->datestampFormat('l jS \of F Y');

// Current Format
echo "Current format [eng]: " . $pg->lang('eng')->datestampFormat() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->datestampFormat() . "\n\n";

// Datestamp: Current Format
echo "Datestamp [eng]: " . $pg->lang('eng')->datestamp() . "\n";
echo "Datestamp [ja]: " . $pg->lang('ja')->datestamp() . "\n\n";

// Configure Format: ja
$pg->lang('ja')->datestampFormat('n月j日(\'y)');

// Reset Format: eng
$pg->lang('eng')->resetDatestampFormat();

// Current Format
echo "Current format [eng]: " . $pg->lang('eng')->datestampFormat() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->datestampFormat() . "\n\n";

// Datestamp: Current Format
echo "Datestamp [eng]: " . $pg->lang('eng')->datestamp() . "\n";
echo "Datestamp [ja]: " . $pg->lang('ja')->datestamp() . "\n\n";

5.2.4.2. Output

ConfigDatestampFormat.txt

[img/with_gps.jpg]--------------------
Current format [eng]: Y/m/d
Current format [ja]: Y年m月d日

Datestamp [eng]: 2023/09/18
Datestamp [ja]: 2023年09月18日

Current format [eng]: l jS \of F Y
Current format [ja]: Y年m月d日

Datestamp [eng]: Monday 18th of September 2023
Datestamp [ja]: 2023年09月18日

Current format [eng]: Y/m/d
Current format [ja]: n月j日('y)

Datestamp [eng]: 2023/09/18
Datestamp [ja]: 9月18日('23)

5.2.4.3. Details

Get Format: datestampFormat()
Set Format: datestampFormat($format)
Reset Format: resetDatestampFormat()
Default Format:
- eng: Y/m/d
- ja: Y年m月d日
Format parameter strings: See PHP Official

5.2.5. Timestamp Data Format

for timestamp()

5.2.5.1. PHP
5.2.5.2. Output
5.2.5.3. Details

5.2.5.1. PHP

ConfigTimestampFormat.php

<?php

require_once __DIR__ . '/../vendor/autoload.php';

use Macocci7\PhpPhotoGps\PhotoGps;

$filename = 'img/with_gps.jpg';
$pg = new PhotoGps($filename);

echo "[" . $filename . "]--------------------\n";

// Format: default
echo "Current format [eng]: " . $pg->lang('eng')->timestampFormat() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->timestampFormat() . "\n\n";

// Timestamp: default format
echo "Timestamp [eng]: " . $pg->lang('eng')->timestamp() . "\n";
echo "Timestamp [ja]: " . $pg->lang('ja')->timestamp() . "\n\n";

// Configure Format: eng
$pg->lang('eng')->timestampFormat('g:i a');

// Current Format
echo "Current format [eng]: " . $pg->lang('eng')->timestampFormat() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->timestampFormat() . "\n\n";

// Timestamp: Current Format
echo "Timestamp [eng]: " . $pg->lang('eng')->timestamp() . "\n";
echo "Timestamp [ja]: " . $pg->lang('ja')->timestamp() . "\n\n";

// Configure Format: ja
$pg->lang('ja')->timestampFormat('G時i分s秒');

// Reset Format: eng
$pg->lang('eng')->resetTimestampFormat();

// Current Format
echo "Current format [eng]: " . $pg->lang('eng')->timestampFormat() . "\n";
echo "Current format [ja]: " . $pg->lang('ja')->timestampFormat() . "\n\n";

// Timestamp: Current Format
echo "Timestamp [eng]: " . $pg->lang('eng')->timestamp() . "\n";
echo "Timestamp [ja]: " . $pg->lang('ja')->timestamp() . "\n\n";

5.2.5.2. Output

ConfigTimestampFormat.txt

[img/with_gps.jpg]--------------------
Current format [eng]: H:i:s
Current format [ja]: H時i分s秒

Timestamp [eng]: 03:43:32
Timestamp [ja]: 03時43分32秒

Current format [eng]: g:i a
Current format [ja]: H時i分s秒

Timestamp [eng]: 3:43 am
Timestamp [ja]: 03時43分32秒

Current format [eng]: H:i:s
Current format [ja]: G時i分s秒

Timestamp [eng]: 03:43:32
Timestamp [ja]: 3時43分32秒

5.2.5.3. Details

Get Format: timestampFormat()
Set Format: timestampFormat($format)
Reset Format: resetTimestampFormat()
Default Format:
- eng: H:i:s
- ja: H時i分s秒
Format parameter strings: See PHP Official

5.3. Usage: Photo List with Checking Geo Data

Geo Data means latitude and longitude here.

The code below creates a list of photos in the dir img/.

5.3.1. PHP
5.3.2. Result
5.3.3. Details

5.3.1. PHP

CheckGeoData.php

<?php

require_once __DIR__ . '/../vendor/autoload.php';

use Macocci7\PhpPhotoGps\PhotoGps;

$pg = new PhotoGps();

$images = glob('img/*.{jp*g,JP*G}', GLOB_BRACE);
sort($images);

echo "# Photo List: Geo Data\n\n";
echo "<table>\n";
echo "<tr><th>Image</th><th>Geo</th><th>Coordinate</th></tr>\n";
foreach ($images as $file) {
    $link = sprintf("<a href='%s'><img src='%s' width=100 /></a>", $file, $file);
    $pg->load($file);
    $hasGps = $pg->hasGps();
    $hasGeo = $pg->hasGeo();
    $hasAltitude = $pg->hasAltitude();
    echo sprintf("<td>%s</td>", $link);
    echo sprintf("<td>%s</td>", $hasGps ? 'o' : 'x');
    echo "<td>\n";
    if ($hasGeo) {
        echo sprintf(
            "<a href='%s'>%s, %s</a><br />\n",
            sprintf(
                "https://www.google.com/maps/place/%s+%s/@%.7f,%.7f,17z/?authuser=0&entry=ttu",
                urlencode($pg->lang('eng')->latitudeS()),
                urlencode($pg->lang('eng')->longitudeS()),
                $pg->latitudeD(),
                $pg->longitudeD()
            ),
            sprintf("%.14f", $pg->latitudeD()),
            sprintf("%.14f", $pg->longitudeD())
        );
        foreach ($pg->langs() as $lang) {
            echo sprintf(
                "%s, %s<br />\n",
                $pg->lang($lang)->latitudeS(),
                $pg->lang($lang)->longitudeS()
            );
        }
    } else {
        echo "No Geo Data\n\n";
    }
    if ($hasAltitude) {
        foreach ($pg->langs() as $lang) {
            echo sprintf("%s\n\n", $pg->lang($lang)->altitudeS());
        }
    } else {
        echo "No Altitude Data\n\n";
    }
    echo "</td></tr>\n";
}
echo "</table>\n";

5.3.2. Result

CheckGeoData.md

Photo List: Geo Data

Image	Geo	Coordinate
	o	31.53324552730697, 35.47923749904281 31°31'59.7"N, 35°28'45.3"E 北緯31度31分59.7秒, 東経35度28分45.3秒 (Below Sea Level) 422.00 m （負値海抜） 422.00 メートル
	o	-20.18913849132269, -67.58772465286874 20°11'20.9"S, 67°35'15.8"W 南緯20度11分20.9秒, 西経67度35分15.8秒 (Above Sea Level) 3700.00 m （正値海抜） 3700.00 メートル
	o	35.87235861111111, 139.78356388888889 35°52'20.5"N, 139°47'0.8"E 北緯35度52分20.5秒, 東経139度47分0.8秒 (Above Ellipsoidal Surface) 3.70 m （正値楕円体高） 3.70 メートル
	o	38.26386166666666, 140.87085083333335 38°15'49.9"N, 140°52'15.1"E 北緯38度15分49.9秒, 東経140度52分15.1秒 (Above Ellipsoidal Surface) 42.00 m （正値楕円体高） 42.00 メートル
	o	37.05727416666667, 140.89244166666666 37°3'26.2"N, 140°53'32.8"E 北緯37度3分26.2秒, 東経140度53分32.8秒 (Above Ellipsoidal Surface) 13.00 m （正値楕円体高） 13.00 メートル
	x	No Geo Data No Altitude Data

5.3.3. Details

Load GPS Data from a photo: load($path)
Check If GPS Data Exists: hasGps()
Check If Geo Data Exists: hasGeo()
Check If Altitude Exists: hasAltitude()

5.4. Usage: Read All GPS Tags

gps() method returns all Exif tags which has GPS prefix.

5.4.1. PHP
5.4.2. Result
5.4.3. Details

5.4.1. PHP

ReadAllGpsTags.md

<?php

require_once __DIR__ . '/../vendor/autoload.php';

use Macocci7\PhpPhotoGps\PhotoGps;
use Macocci7\PhpPhotoGps\Helpers\Dir;
use Macocci7\PhpPhotoGps\Helpers\Arrow;
use Macocci7\PhpPhotoGps\Helpers\Exif;

$pg = new PhotoGps();
$images = [
    'File with Fake GPS via HTTP' => 'http://macocci7.net/photo/gps/remote_fake_gps_001.jpg',
    'File with Fake GPS via HTTPS' => 'https://macocci7.net/photo/gps/remote_fake_gps_002.jpg',
    'Local File with GPS' => 'img/with_gps.jpg',
    'No GPS tags' => 'img/without_gps.jpg',
];
$arrowSize = 30;

Dir::clear('./download/');
echo "# Exif: GPS Tags\n\n";

// Loop for images
foreach ($images as $title => $image) {
    echo "## $title\n\n";
    // Start Table
    echo "<table>\n";
    $style = 'display: flex; align-items: top;';
    echo sprintf("<tr style='%s'>\n<td>\n", $style);

    // Thumbnail
    echo "<img src='$image' alt='$title' width='200'>\n\n";

    // Load GPS Data
    $pg->load($image);

    // Show Attributes Converted from GPS Data
    $style = 'display: flex; justify-content: right; align-items: center;';
    $direction = $pg->direction();
    $speedS = $pg->speedS();
    $track = $pg->track();
    $destBearing = $pg->destBearing();
    $datestamp = $pg->datestamp();
    $timestamp = $pg->timestamp();

    echo "|Attribute|Value|\n";
    echo "|:---|---:|\n";
    echo sprintf("|ExifVersion|%s|\n", Exif::version());

    // Image Direction
    if (!is_null($direction)) {
        $pathArrow = sprintf('img/arrow%.2f.png', $direction);
        Arrow::make($direction)->save($pathArrow);
        echo sprintf(
            "|Image Direction|<div style='%s'><img src='%s' width=%d height=%d />%s</div>|\n",
            $style,
            $pathArrow,
            $arrowSize,
            $arrowSize,
            $pg->directionS()
        );
    }

    // Speed
    if (!is_null($speedS)) {
        echo sprintf("|Speed|%s|\n", $speedS);
    }

    // Track
    if (!is_null($track)) {
        $pathArrow = sprintf('img/arrow%.2f.png', $track);
        Arrow::make($track)->save($pathArrow);
        echo sprintf(
            "|Track|<div style='%s'><img src='%s' width=%d height=%d />%s</div>|\n",
            $style,
            $pathArrow,
            $arrowSize,
            $arrowSize,
            $pg->trackS()
        );
    }

    // Dest Bearing
    if (!is_null($destBearing)) {
        $pathArrow = sprintf('img/arrow%.2f.png', $destBearing);
        Arrow::make($destBearing)->save($pathArrow);
        echo sprintf(
            "|Destination Bearing|<div style='%s'><img src='%s' width=%d height=%d />%s</div>|\n",
            $style,
            $pathArrow,
            $arrowSize,
            $arrowSize,
            $pg->destBearingS()
        );
    }

    // Date Stamp
    echo $datestamp ? sprintf("|Datestamp|%s (UTC)|\n", $datestamp) : '';

    // Time Stamp
    echo $timestamp ? sprintf("|Timestamp|%s (UTC)|\n", $timestamp) : '';

    echo "</td>\n<td>\n\n";

    // Check If GPS Data Exists
    if ($pg->hasGps()) {
        // Show GPS Data
        echo "|Tag|Value|\n";
        echo "|:---|---:|\n";
        foreach ($pg->gps() as $tag => $value) {
            echo sprintf(
                "|%s|%s|\n",
                $tag,
                is_array($value) ? implode('<br />', $value) : $value
            );
        }
    } else {
        echo "No GPS data.\n\n";
    }

    // Close Table
    echo "</td>\n</tr>\n</table>\n\n";
}

5.4.2. Result

ReadAllGpsTags.md

Exif: GPS Tags

File with Fake GPS via HTTP

Attribute	Value
ExifVersion	0300
Image Direction	M 352.40°
Speed	12.45kt
Track	M 62.90°
Destination Bearing	M 138.69°
Datestamp	2018/03/31 (UTC)
Timestamp	02:22:14 (UTC)

Tag	Value
GPS_IFD_Pointer	366
GPSLatitudeRef	N
GPSLatitude	31/1 34/1 8083/1000
GPSLongitudeRef	E
GPSLongitude	35/1 30/1 5245/1000
GPSAltitudeRef	3
GPSAltitude	42200/100
GPSTimeStamp	2/1 22/1 14/1
GPSSpeedRef	N
GPSSpeed	22778/1829
GPSTrackRef	M
GPSTrack	157243/2500
GPSImgDirectionRef	M
GPSImgDirection	195581/555
GPSDestBearingRef	M
GPSDestBearing	83632/603
GPSDateStamp	2018:03:31

File with Fake GPS via HTTPS

Attribute	Value
ExifVersion	0300
Image Direction	T 278.63°
Speed	100.00mph
Track	T 268.44°
Destination Bearing	T 273.47°
Datestamp	2015/06/07 (UTC)
Timestamp	01:31:46 (UTC)

Tag	Value
GPS_IFD_Pointer	214
GPSLatitudeRef	S
GPSLatitude	20/1 11/1 20898/1000
GPSLongitudeRef	W
GPSLongitude	67/1 35/1 15808/1000
GPSAltitudeRef	0
GPSAltitude	370000/100
GPSTimeStamp	1/1 31/1 46/1
GPSSpeedRef	M
GPSSpeed	100/1
GPSTrackRef	T
GPSTrack	143885/536
GPSImgDirectionRef	T
GPSImgDirection	115074/413
GPSDestBearingRef	T
GPSDestBearing	188418/689
GPSDateStamp	2015:06:07

Local File with GPS

Attribute	Value
ExifVersion	0300
Image Direction	T 306.25°
Speed	1.60mph
Track	M 359.90°
Datestamp	2023/09/18 (UTC)
Timestamp	03:43:32 (UTC)

Tag	Value
GPS_IFD_Pointer	908
GPSLatitudeRef	N
GPSLatitude	37/1 3/1 26187/1000
GPSLongitudeRef	E
GPSLongitude	140/1 53/1 32790/1000
GPSAltitudeRef	0
GPSAltitude	1300/100
GPSTimeStamp	3/1 43/1 32/1
GPSSpeedRef	M
GPSSpeed	16/10
GPSTrackRef	M
GPSTrack	224936/625
GPSImgDirectionRef	T
GPSImgDirection	191409/625
GPSDateStamp	2023:09:18

No GPS tags

Attribute	Value
ExifVersion	0220

No GPS data.

5.4.3. Details

use declaration: use Macocci7\PhpPhotoGps\Helpers\Dir;

to clear entries in download directory.
use declaration: use Macocci7\PhpPhotoGps\Helpers\Arrow;

to create arrow images.
Clear entries in a directory: Dir::clear($dir)
Get Image Direction:
- As Float: direction() returns null if not found.
- As String: directionS() return null if not found.
Get Speed:
- As Float: speed() returns null if not found.
- As String: speedS() returns null if not found.
Get Track (Direction of Movement):
- As Float: track() returns null if not found.
- As String: trackS() returns null if not found.
Get Destination Bearing:
- As Float: destBearing() returns null if not found.
- As String: destBearingS() returns null if not found.
Get Date Stamp: datestamp() returns null if not found.
Get Time Stamp: timestamp() returns null if not found.
Create Arrow Image: Arrow::make($degree)->save($pathArrow)
- $degree: must be in clockwise degrees. (0° ～ 360°)
- Arrow:make(): returns the instance of Intervention\Image\Interfaces\ImageInterface (v3.3)
- Returning HTTP Response with it is available.
- See more: Intervention/image Official Document
  
  response() has removed since v3.
  
  See more: Removed Features | Intervention/image v3 Official
- Note:
  - If the reference is 'M' (Magnetic North), the arrow image shows the relative direction from Magnetic North(Magnetic North upward).
  - Magnetic North pole moves over time. See more.
Note:
- All photos in this repository were taken by macocci7 with mobile phone, and free to use.
- Some of GPS data was manually injected with some tools.
  - GIMP v2.10.34 used for:
    - GPSLatitudeRef
    - GPSLatitude
    - GPSLongitudeRef
    - GPSLongitude
    - GPSAltitudeRef
    - GPSAltitude
    GIMP can edit only geo tags.
  - Exif Tool by Phil Harvey v12.72 used for:
    - All other GPS tags
    Exif Tool can edit all writable GPS tags.
    
    However, Exif Tool currently cannot set GPSSpeedRef as K (maybe a bug).

5.5. Usage: GPS Attribute Information

5.5.1. PHP
5.5.2. Result
5.5.3. Details

5.5.1. PHP

GpsAttrInfo.php

<?php

require_once __DIR__ . '/../vendor/autoload.php';

use Macocci7\PhpPhotoGps\Helpers\Gps;

//$exifVersion = "0210";
//$exifVersion = "0220";
//$exifVersion = "0221";
//$exifVersion = "0230";
//$exifVersion = "0231";
//$exifVersion = "0232";
$exifVersion = "0300";
echo "# Exif" . $exifVersion . ": GPS Attribute Information\n\n";
echo "|Field Name|Type|Count|Values|Default|Separator|\n";
echo "|:---|:---|---:|:---|:---:|:---:|\n";
foreach (Gps::def('exif' . $exifVersion . '.fields') as $key => $value) {
    echo sprintf(
        "|%s|%s|%d|%s|%s|%s|\n",
        $key,
        $value['type'],
        $value['count'],
        isset($value['values'])
        ? implode(
            '<br />',
            array_map(
                fn ($k, $v) => '* ' . $k . ': ' . $v,
                array_keys($value['values']),
                $value['values']
            )
        )
        : '---',
        $value['default'] ?? '---',
        $value['separator'] ?? '---'
    );
}

5.5.2. Result

GpsAttrInfo.md

Exif0300: GPS Attribute Information

Field Name	Type	Count	Values	Default	Separator
GPSVersion	BYTE	4	---	2.4.0.0	.
GPSVersionID	BYTE	4	---	2.4.0.0	.
GPSLatitudeRef	ASCII	2	* N: North latitude * S: South latitude	None	---
GPSLatitude	RATIONAL	3	---	None	---
GPSLongitudeRef	ASCII	2	* E: East longitude * W: West longitude	None	---
GPSLongitude	RATIONAL	3	---	None	---
GPSAltitudeRef	BYTE	1	* 0: Positive ellipsoidal height (at or above ellipsoidal surface) * 1: Negative ellipsoid height (below ellipsoidal surface) * 2: Positive sea level value (at or above sea level reference) * 3: Negative sea level value (below sea level reference)	0
GPSAltitude	RATIONAL	1	---	None	---
GPStimeStamp	RATIONAL	3	---	None	---
GPSSatellites	ASCII	0	---	None	---
GPSStatus	ASCII	2	* A: Measurement in progress * V: Measurement interrupted	None	---
GPSMeasureMode	ASCII	2	* 2: 2-dimensional measurement * 3: 3-dimensional measurement	None	---
GPSDOP	RATIONAL	1	---	None	---
GPSSpeedRef	ASCII	2	* K: Kilometers per hour * M: Miles per hour * N: Knots	K	---
GPSSpeed	RATIONAL	1	---	None	---
GPSTrackRef	ASCII	2	* T: True direction * M: Magnetic direction	T	---
GPSTrack	RATIONAL	1	---	None	---
GPSImgDirectionRef	ASCII	2	* T: True direction * M: Magnetic direction	T	---
GPSImgDirection	RATIONAL	1	---	None	---
GPSMapDatum	ASCII	0	---	None	---
GPSDestLatitudeRef	ASCII	2	* N: North latitude * S: South latitude	None	---
GPSDestLatitude	RATIONAL	3	---	None	---
GPSDestLongitudeRef	ASCII	2	* E: East longitude * W: West longitude	None	---
GPSDestLongitude	RATIONAL	3	---	None	---
GPSDestBearingRef	ASCII	2	* T: True direction * M: Magnetic direction	T	---
GPSDestBearing	RATIONAL	1	---	None	---
GPSDestDistanceRef	ASCII	2	* K: Kilometers * M: Miles * N: Nautical miles	K	---
GPSDestDistance	RATIONAL	1	---	None	---
GPSProcessingMethod	UNDEFINED	0	* GPS: GPS [GPSMeaMeasureMode: 2 or 3] * QZSS: Quasi-Zenith Satellite System [GPSMeasureMode: 2 or 3] * GALILEO: Galileo System [GPSMeasureMode: 2 or 3] * GLONASS: Global Navigation Satellite System [GPSMeasureMode: 2 or 3] * BEIDOU: Beidou Satellite Positioning System [GPSMeasureMode: 2 or 3] * NAVID: Navigation Indian Constellation System [GPSMeasureMode: 2 or 3] * CELLID: Mobile Phone Base Stations [GPSMeasureMode: 2 (generally)] * WLAN: Wireless LAN [GPSMeasureMode: 2 (generally)] * MANUAL: Manual input [GPSMeasureMode: (not recorded)]	None	---
GPSAreaInformation	UNDEFINED	0	---	None	---
GPSDateStamp	ASCII	11	---	None	---
GPSDifferential	SHORT	1	* 0: Measurement without differential correction * 1: Differential correction applied	None	---
GPSHPositioningError	RATIONAL	1	---	None	---

5.5.3. Details

use declaration: use Macocci7\PhpPhotoGps\Helpers\Gps;

to use GPS Data Interface.
Get GPS Tag Attributes: Gps::def() or Gps::def($tagName)

it returns null if not found.

GPS Tag Attributes are defined in config/Gps.neon.

The structure of Hash array returned by Gps::def() is as below:
- exifXXXX: XXXX is replaced with Exif Version number.
  - fields:
    - TagName: like GPSVersionID or GPSAltitude
      - type: based on Exif Standard
      - count: based on Exif Standard
      - default: based on Exif Standard
      - values: based on Exif Standard
      - separator: originaly added
Object-like dot-separated specifiers are available for $tagName.

For example, Gps::def('exif0300.fields.GPSLatitudeRef') returns:
```
[
    'type' => 'ASCII',
    'count' => 2,
    'default' => 'None'
    'values' => [
        'N' => 'North latitude',
        'S' => 'South latitude',
    ],
];
```

6. Examples

BasicUsage.php >> results in BasicUsage.txt
CheckGeoData.php >> results in CheckGeoData.md
ConfigFormat.php >> results in ConfigFormat.txt
ConfigDirectionFormat.php >> results in ConfigDirectionFormat.txt
ConfigSpeedFormat.php >> results in ConfigSpeedFormat.txt
ReadAllGpsTags.php >> results in ReadAllGpsTags.md
GpsAttrInfo.php >> results in GpsAttrInfo.md

7. LICENSE

MIT

8. Changelog

2024/04/20: version updated => 1.8.0

What's Changed

Version Updated: Intervention/Image: 3.5 => 3.6
Changed: Helper to Helpers
Updated: examples
Updated: README

2024/04/18: version updated => 1.7.0

What's Changed

Version Updated: Intervention/Image: 3.3 => 3.5
Version Updated: PHPUnit/PHPUnit: 9.6 => 10.5
Updated: Tests to use DataProvider Attribute.
Removed: composer.lock and .php-version from git control.
Updated: Helpers\Exif::simplifyDegrees() to use explicit conversion from float to int.
Updated: GitHub Workflows.
Updated: examples
Updated: README

2024/02/06: version updated => 1.6.0

What's Changed

Version Updated: Intervention/Image: 2.7 => 3.3
Deprecated: Supporting PHP 8.0
Updated: README

2024/02/06: version updated => 1.5.6

Improvement

Added: DatestampFormat()
Added: resetDatestampFormat()
Added: TimestampFormat()
Added: resetTimestampFormat()
Updated: README

2024/02/06: version updated => 1.5.5

Improvement

Updated: README

2024/02/05: version updated => 1.5.4

Improvement

Added: directionFormat()
Added: resetDirectionFormat()
Added: speedFormat()
Added: resetSpeedFormat()

2024/01/27: version updated => 1.5.3

Improvement

Updated: directionS() supports lang('ja')
Updated: TrackS() supports lang('ja')
Updated: destBearingS() supports lang('ja')

2024/01/14: version updated => 1.5.2

Improvement

Updated: example
Updated: README

2024/01/14: version updated => 1.5.1

Improvement

Updated: README

2024/01/14: version updated => 1.5.0

Improvement

Updated: Exif versions prior to Version 3.0 are now supported.
- Exif Version 2.32 (Released: May 2019)
- Exif Version 2.31 (Released: July 2016)
- Exif Version 2.3 (Released: April 2010)
- Exif Version 2.21 (Released: September 2003)
- Exif Version 2.2 (Released: April 2002)
- Exif Version 2.1 (Released: December 1998)
GPS Tag Definitions are based on PDF files on Websites of CIPA and Wikipedia.
Updated: examples.
Updated: README

2024/01/09: version updated => 1.4.1

Improvement

Fixed: Macocci7\PhpPhotoGps\Helpers\Arrow retunrs Intervention\Image\Image
Fixed: example/ConfigFormat.php
Updated: wrong statements in README corrected.

2024/01/08: version updated => 1.4.0

Added

Support remote image. (only http:, https:)
Support other GPS tags.
- ImgDirection, Track, DestDirection, Speed, DateStamp, TimeStamp
- Example: GPS Attribute Information added.
Support Conversion
- BYTE Data into Array
- BYTE Data into ASCII
- RATIONAL Data into Float
- Strip NULL BYTE
Support Arrow Image for Direction Display
Method: hasGeo() judges if longitude or latitude exists.
Method: hasAltitude() juges if altitude exists.
Method: altitudeS() returns formatted altitude.
Method: direction() and directionS() returns converted GPSImgDirection.
Method: speed() and sppedS() returns converted GPSSpeed.
Method: destBearing() and destBearingS() returns converted GPSDestBearing.
Method: track() and trackS() returns converted GPSTrack
Method: datestamp() and timestamp() returns converted GPSDateStamp and GPSTimeStamp.

Improvement

Update: hasGps() judges if any GPS tag exists.

2024/01/02: version updated => 1.3.1

resetting format enabled, documents updated

2024/01/01: version updated => 1.3.0

format configuration enabled

2023/11/11: version updated => 1.2.0

usages of some methods have been changed

Document created: 2023/09/30

Document updated: 2024/04/20

macocci7 / php-photo-gps

Maintainers

Details

README

1. Features

2. Contents

3. Requirements

4. Installation

5. Usage

5.1. Usage: Basic

5.1.1. PHP

5.1.2. Output

5.1.3. Details

5.2. Usage: Format Configuration

5.2.1. Geo Data Format

5.2.1.1. PHP

5.2.1.2. Output

5.2.1.3. Details

5.2.2. Direction Data Format

5.2.2.1. PHP

5.2.2.2. Output

5.2.2.3. Details

5.2.3. Speed Data Format

5.2.3.1. PHP

5.2.3.2. Output

5.2.3.3. Details

5.2.4. Datestamp Data Format

5.2.4.1. PHP

5.2.4.2. Output

5.2.4.3. Details

5.2.5. Timestamp Data Format

5.2.5.1. PHP

5.2.5.2. Output

5.2.5.3. Details

5.3. Usage: Photo List with Checking Geo Data

5.3.1. PHP

5.3.2. Result

Photo List: Geo Data

5.3.3. Details

5.4. Usage: Read All GPS Tags

5.4.1. PHP

5.4.2. Result

Exif: GPS Tags

File with Fake GPS via HTTP

File with Fake GPS via HTTPS

Local File with GPS

No GPS tags

5.4.3. Details

5.5. Usage: GPS Attribute Information

5.5.1. PHP

5.5.2. Result

Exif0300: GPS Attribute Information

5.5.3. Details

6. Examples

7. LICENSE

8. Changelog

2024/04/20: version updated => 1.8.0

What's Changed

2024/04/18: version updated => 1.7.0

What's Changed

2024/02/06: version updated => 1.6.0

What's Changed

2024/02/06: version updated => 1.5.6

Improvement

2024/02/06: version updated => 1.5.5

Improvement

2024/02/05: version updated => 1.5.4

Improvement

2024/01/27: version updated => 1.5.3

Improvement

2024/01/14: version updated => 1.5.2

Improvement

2024/01/14: version updated => 1.5.1

Improvement

2024/01/14: version updated => 1.5.0

Improvement

2024/01/09: version updated => 1.4.1

Improvement

2024/01/08: version updated => 1.4.0

Added