├── GPS Encoder Documentation.txt.meta ├── GPSEncoder.cs ├── GPSEncoder.cs.meta ├── GPSEncoder.unitypackage ├── GPSEncoder.unitypackage.meta ├── LGPL-3.0.txt └── Readme.md /GPS Encoder Documentation.txt.meta: -------------------------------------------------------------------------------- 1 | fileFormatVersion: 2 2 | guid: 3ce5b5d9f07a6fa47a0caaf47495dc73 3 | TextScriptImporter: 4 | userData: 5 | -------------------------------------------------------------------------------- /GPSEncoder.cs: -------------------------------------------------------------------------------- 1 | //Copyright 2013 MichaelTaylor3D 2 | //www.michaeltaylor3d.com 3 | 4 | using UnityEngine; 5 | 6 | public sealed class GPSEncoder { 7 | 8 | ///////////////////////////////////////////////// 9 | //////-------------Public API--------------////// 10 | ///////////////////////////////////////////////// 11 | 12 | /// 13 | /// Convert UCS (X,Y,Z) coordinates to GPS (Lat, Lon) coordinates 14 | /// 15 | /// 16 | /// Returns Vector2 containing Latitude and Longitude 17 | /// 18 | /// 19 | /// (X,Y,Z) Position Parameter 20 | /// 21 | public static Vector2 USCToGPS(Vector3 position) 22 | { 23 | return GetInstance().ConvertUCStoGPS(position); 24 | } 25 | 26 | /// 27 | /// Convert GPS (Lat, Lon) coordinates to UCS (X,Y,Z) coordinates 28 | /// 29 | /// 30 | /// Returns a Vector3 containing (X, Y, Z) 31 | /// 32 | /// 33 | /// (Lat, Lon) as Vector2 34 | /// 35 | public static Vector3 GPSToUCS(Vector2 gps) 36 | { 37 | return GetInstance().ConvertGPStoUCS(gps); 38 | } 39 | 40 | /// 41 | /// Convert GPS (Lat, Lon) coordinates to UCS (X,Y,Z) coordinates 42 | /// 43 | /// 44 | /// Returns a Vector3 containing (X, Y, Z) 45 | /// 46 | public static Vector3 GPSToUCS(float latitude, float longitude) 47 | { 48 | return GetInstance().ConvertGPStoUCS(new Vector2(latitude,longitude)); 49 | } 50 | 51 | /// 52 | /// Change the relative GPS offset (Lat, Lon), Default (0,0), 53 | /// used to bring a local area to (0,0,0) in UCS coordinate system 54 | /// 55 | /// 56 | /// Referance point. 57 | /// 58 | public static void SetLocalOrigin(Vector2 localOrigin) 59 | { 60 | GetInstance()._localOrigin = localOrigin; 61 | } 62 | 63 | ///////////////////////////////////////////////// 64 | //////---------Instance Members------------////// 65 | ///////////////////////////////////////////////// 66 | 67 | #region Singleton 68 | private static GPSEncoder _singleton; 69 | 70 | private GPSEncoder() 71 | { 72 | 73 | } 74 | 75 | private static GPSEncoder GetInstance() 76 | { 77 | if(_singleton == null) 78 | { 79 | _singleton = new GPSEncoder(); 80 | } 81 | return _singleton; 82 | } 83 | #endregion 84 | 85 | #region Instance Variables 86 | private Vector2 _localOrigin = Vector2.zero; 87 | private float _LatOrigin { get{ return _localOrigin.x; }} 88 | private float _LonOrigin { get{ return _localOrigin.y; }} 89 | 90 | private float metersPerLat; 91 | private float metersPerLon; 92 | #endregion 93 | 94 | #region Instance Functions 95 | private void FindMetersPerLat(float lat) // Compute lengths of degrees 96 | { 97 | float m1 = 111132.92f; // latitude calculation term 1 98 | float m2 = -559.82f; // latitude calculation term 2 99 | float m3 = 1.175f; // latitude calculation term 3 100 | float m4 = -0.0023f; // latitude calculation term 4 101 | float p1 = 111412.84f; // longitude calculation term 1 102 | float p2 = -93.5f; // longitude calculation term 2 103 | float p3 = 0.118f; // longitude calculation term 3 104 | 105 | lat = lat * Mathf.Deg2Rad; 106 | 107 | // Calculate the length of a degree of latitude and longitude in meters 108 | metersPerLat = m1 + (m2 * Mathf.Cos(2 * (float)lat)) + (m3 * Mathf.Cos(4 * (float)lat)) + (m4 * Mathf.Cos(6 * (float)lat)); 109 | metersPerLon = (p1 * Mathf.Cos((float)lat)) + (p2 * Mathf.Cos(3 * (float)lat)) + (p3 * Mathf.Cos(5 * (float)lat)); 110 | } 111 | 112 | private Vector3 ConvertGPStoUCS(Vector2 gps) 113 | { 114 | FindMetersPerLat(_LatOrigin); 115 | float zPosition = metersPerLat * (gps.x - _LatOrigin); //Calc current lat 116 | float xPosition = metersPerLon * (gps.y - _LonOrigin); //Calc current lat 117 | return new Vector3((float)xPosition, 0, (float)zPosition); 118 | } 119 | 120 | private Vector2 ConvertUCStoGPS(Vector3 position) 121 | { 122 | FindMetersPerLat(_LatOrigin); 123 | Vector2 geoLocation = new Vector2(0,0); 124 | geoLocation.x = (_LatOrigin + (position.z)/metersPerLat); //Calc current lat 125 | geoLocation.y = (_LonOrigin + (position.x)/metersPerLon); //Calc current lon 126 | return geoLocation; 127 | } 128 | #endregion 129 | } 130 | -------------------------------------------------------------------------------- /GPSEncoder.cs.meta: -------------------------------------------------------------------------------- 1 | fileFormatVersion: 2 2 | guid: bd2308fff51941749860bbc0e959bc03 3 | MonoImporter: 4 | serializedVersion: 2 5 | defaultReferences: [] 6 | executionOrder: 0 7 | icon: {instanceID: 0} 8 | userData: 9 | -------------------------------------------------------------------------------- /GPSEncoder.unitypackage: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/MichaelTaylor3D/UnityGPSConverter/e44336b9c40012d0cbe809234ef0c0d843e478e9/GPSEncoder.unitypackage -------------------------------------------------------------------------------- /GPSEncoder.unitypackage.meta: -------------------------------------------------------------------------------- 1 | fileFormatVersion: 2 2 | guid: c5ba54b6955fc4648af44289d101069d 3 | DefaultImporter: 4 | userData: 5 | -------------------------------------------------------------------------------- /LGPL-3.0.txt: -------------------------------------------------------------------------------- 1 | GNU LESSER GENERAL PUBLIC LICENSE 2 | Version 3, 29 June 2007 3 | 4 | Copyright (C) 2007 Free Software Foundation, Inc. 5 | Everyone is permitted to copy and distribute verbatim copies 6 | of this license document, but changing it is not allowed. 7 | 8 | 9 | This version of the GNU Lesser General Public License incorporates 10 | the terms and conditions of version 3 of the GNU General Public 11 | License, supplemented by the additional permissions listed below. 12 | 13 | 0. Additional Definitions. 14 | 15 | As used herein, "this License" refers to version 3 of the GNU Lesser 16 | General Public License, and the "GNU GPL" refers to version 3 of the GNU 17 | General Public License. 18 | 19 | "The Library" refers to a covered work governed by this License, 20 | other than an Application or a Combined Work as defined below. 21 | 22 | An "Application" is any work that makes use of an interface provided 23 | by the Library, but which is not otherwise based on the Library. 24 | Defining a subclass of a class defined by the Library is deemed a mode 25 | of using an interface provided by the Library. 26 | 27 | A "Combined Work" is a work produced by combining or linking an 28 | Application with the Library. The particular version of the Library 29 | with which the Combined Work was made is also called the "Linked 30 | Version". 31 | 32 | The "Minimal Corresponding Source" for a Combined Work means the 33 | Corresponding Source for the Combined Work, excluding any source code 34 | for portions of the Combined Work that, considered in isolation, are 35 | based on the Application, and not on the Linked Version. 36 | 37 | The "Corresponding Application Code" for a Combined Work means the 38 | object code and/or source code for the Application, including any data 39 | and utility programs needed for reproducing the Combined Work from the 40 | Application, but excluding the System Libraries of the Combined Work. 41 | 42 | 1. Exception to Section 3 of the GNU GPL. 43 | 44 | You may convey a covered work under sections 3 and 4 of this License 45 | without being bound by section 3 of the GNU GPL. 46 | 47 | 2. Conveying Modified Versions. 48 | 49 | If you modify a copy of the Library, and, in your modifications, a 50 | facility refers to a function or data to be supplied by an Application 51 | that uses the facility (other than as an argument passed when the 52 | facility is invoked), then you may convey a copy of the modified 53 | version: 54 | 55 | a) under this License, provided that you make a good faith effort to 56 | ensure that, in the event an Application does not supply the 57 | function or data, the facility still operates, and performs 58 | whatever part of its purpose remains meaningful, or 59 | 60 | b) under the GNU GPL, with none of the additional permissions of 61 | this License applicable to that copy. 62 | 63 | 3. Object Code Incorporating Material from Library Header Files. 64 | 65 | The object code form of an Application may incorporate material from 66 | a header file that is part of the Library. You may convey such object 67 | code under terms of your choice, provided that, if the incorporated 68 | material is not limited to numerical parameters, data structure 69 | layouts and accessors, or small macros, inline functions and templates 70 | (ten or fewer lines in length), you do both of the following: 71 | 72 | a) Give prominent notice with each copy of the object code that the 73 | Library is used in it and that the Library and its use are 74 | covered by this License. 75 | 76 | b) Accompany the object code with a copy of the GNU GPL and this license 77 | document. 78 | 79 | 4. Combined Works. 80 | 81 | You may convey a Combined Work under terms of your choice that, 82 | taken together, effectively do not restrict modification of the 83 | portions of the Library contained in the Combined Work and reverse 84 | engineering for debugging such modifications, if you also do each of 85 | the following: 86 | 87 | a) Give prominent notice with each copy of the Combined Work that 88 | the Library is used in it and that the Library and its use are 89 | covered by this License. 90 | 91 | b) Accompany the Combined Work with a copy of the GNU GPL and this license 92 | document. 93 | 94 | c) For a Combined Work that displays copyright notices during 95 | execution, include the copyright notice for the Library among 96 | these notices, as well as a reference directing the user to the 97 | copies of the GNU GPL and this license document. 98 | 99 | d) Do one of the following: 100 | 101 | 0) Convey the Minimal Corresponding Source under the terms of this 102 | License, and the Corresponding Application Code in a form 103 | suitable for, and under terms that permit, the user to 104 | recombine or relink the Application with a modified version of 105 | the Linked Version to produce a modified Combined Work, in the 106 | manner specified by section 6 of the GNU GPL for conveying 107 | Corresponding Source. 108 | 109 | 1) Use a suitable shared library mechanism for linking with the 110 | Library. A suitable mechanism is one that (a) uses at run time 111 | a copy of the Library already present on the user's computer 112 | system, and (b) will operate properly with a modified version 113 | of the Library that is interface-compatible with the Linked 114 | Version. 115 | 116 | e) Provide Installation Information, but only if you would otherwise 117 | be required to provide such information under section 6 of the 118 | GNU GPL, and only to the extent that such information is 119 | necessary to install and execute a modified version of the 120 | Combined Work produced by recombining or relinking the 121 | Application with a modified version of the Linked Version. (If 122 | you use option 4d0, the Installation Information must accompany 123 | the Minimal Corresponding Source and Corresponding Application 124 | Code. If you use option 4d1, you must provide the Installation 125 | Information in the manner specified by section 6 of the GNU GPL 126 | for conveying Corresponding Source.) 127 | 128 | 5. Combined Libraries. 129 | 130 | You may place library facilities that are a work based on the 131 | Library side by side in a single library together with other library 132 | facilities that are not Applications and are not covered by this 133 | License, and convey such a combined library under terms of your 134 | choice, if you do both of the following: 135 | 136 | a) Accompany the combined library with a copy of the same work based 137 | on the Library, uncombined with any other library facilities, 138 | conveyed under the terms of this License. 139 | 140 | b) Give prominent notice with the combined library that part of it 141 | is a work based on the Library, and explaining where to find the 142 | accompanying uncombined form of the same work. 143 | 144 | 6. Revised Versions of the GNU Lesser General Public License. 145 | 146 | The Free Software Foundation may publish revised and/or new versions 147 | of the GNU Lesser General Public License from time to time. Such new 148 | versions will be similar in spirit to the present version, but may 149 | differ in detail to address new problems or concerns. 150 | 151 | Each version is given a distinguishing version number. If the 152 | Library as you received it specifies that a certain numbered version 153 | of the GNU Lesser General Public License "or any later version" 154 | applies to it, you have the option of following the terms and 155 | conditions either of that published version or of any later version 156 | published by the Free Software Foundation. If the Library as you 157 | received it does not specify a version number of the GNU Lesser 158 | General Public License, you may choose any version of the GNU Lesser 159 | General Public License ever published by the Free Software Foundation. 160 | 161 | If the Library as you received it specifies that a proxy can decide 162 | whether future versions of the GNU Lesser General Public License shall 163 | apply, that proxy's public statement of acceptance of any version is 164 | permanent authorization for you to choose that version for the 165 | Library. -------------------------------------------------------------------------------- /Readme.md: -------------------------------------------------------------------------------- 1 | GPS Encoder by Michael Taylor | MichaelTaylor3D 2 | ----------------------------------------- 3 | www.michaeltaylor.dev 4 | 5 | Author: Michael Taylor: 6 | 7 | If this library was useful to you, please consider a small donation. 8 | 9 | ENS: michaeltaylor.dev.eth 10 | 11 | ETHER ADDRESS: 0x411b4F2dCFE158114d9396A30c625Bf7DefAD880 12 | 13 | Copyright (c) Michael Taylor 14 | 15 | This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. 16 | 17 | This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. 18 | 19 | You should have received a copy of the GNU Lesser General Public License along with this program. If not, see http://www.gnu.org/licenses/. 20 | 21 | API: 22 | 23 | public static Vector2 USCToGPS(Vector3 position) 24 | ------------------------------------------------------- 25 | To find the GPS equivalent to your (x,y,z) position in the scene 26 | simply pass that position into this function. 27 | 28 | 29 | public static Vector3 GPSToUCS(Vector2 gps) 30 | public static Vector3 GPSToUCS(float latitude, float longitude) 31 | ------------------------------------------------------- 32 | To find the (X,Y,Z) equivalent of a set of GPS coordinates. 33 | Pass the latitude and longitude into one of these functions. 34 | 35 | 36 | 37 | 38 | public static void SetLocalOrigin(Vector2 localOrigin) 39 | ------------------------------------------------------- 40 | By Default All of your conversions will assume that your using a 41 | latitude/longitude origin of (0,0). This places you at the real life origin 42 | of the earth's lat/lon just outside of the gulf of new guinea, Africa. When using 43 | the default (0,0), all your GPS Conversions will be positioned as they would be 44 | in real life. 45 | 46 | However, sometimes you only want to convert your GPS coordinates to a local area 47 | positioned at the UCS (0,0,0) inside of unity. In order to center a local area 48 | at the origin. You need to find the latitude and longitude that corresponds to 49 | the origin of your scene. If you pass that coordinate into the function. All the 50 | conversions for the rest of your session will be in relation to the new origin. 51 | --------------------------------------------------------------------------------