Changes

Jump to: navigation, search

GeoView

8,366 bytes added, 02:02, 8 July 2021
no edit summary
Work in progress{{man warn|The GeoView addon was originally integrated into earlier Gramps versions than Gramps 3.3 then I created a new map renderer since some month now. go there : [[GeoViewHelp]]|The newer [[Geography]] renderer based on OsmGpsMap was integrated into Gramps 3.3, see the [[User_manual|user manual]] for further information <br>[[Gramps_{{man version}}_Wiki_Manual_-_Categories#Geography_Category]]}}
Be patient.{{man warn|Instructions for the older GeoView addon that was based on webkit/gtkmozembed}}
I'm not a native english writer, so I surely do mistakes''All we need to understand GeoView.'''
'''All we need to understand and test == Why GeoView.'''? ==
I would like to see my ancestors all around the world on a map. And if possible, I would like to see them moving during time periods.
== Why GeoView ? The future ==
I would like to see my ancestors all around For approximatively three years, geoview is based on html technology using webkit or gtkmozembed.We have some problems depending on the distribution, the world webkit version, ... : crashes, messages on a mapconsole, .. And if possible, I would like to see them moving during time periods. How to do this easily ? and with the minimum of software !
GeoView The mecanism for rendering the map is one solutionasynchronous and difficult to manage : the renderer and gramps are two different things which don't easily communicate. You can always provide yours !
== The html kits ==We can use webkit or gtkmozembed to view html pages. If no one is installedSo, you'll never see GeoViewI am working on a new map renderer since some month now.
If the two kits you are installedimpatient, webkit will be used.go there : [[Geography]]
For web browsing, we need ==GeoView is divided in two parts : ==This module is now in two parts in 3.2. I'll try to explain how to be connected install them and how to use them. You have two new views named Geography (geoviev) and Web (htmlrenderer).=== The html rendering engine ===This module is called htmlrenderer. We use it when we use the networkWeb view.
Even if you How to do this easily and with the minimum of software to install ?==== The html kits ====The Html rendering machine is used to show remote and local "urls" inside of GRAMPS. We need to be connected to the network. You probably also need a broadband connection to have a html kit installed, can can always say : I don't mind ! I don't want smooth result. Try eg Google maps in your browser to see the HtmlViewif your internet connection is sufficiently fast.
For thisGRAMPS can use two different kind of engines, webkit or gtkmozembed, to view HTML pages. If they are not installed, you can disallow Geoview in 'll never see [[Geography]] and the Internet Maps preferences tabWeb appearing among your views. If you are looking on how to install these, see [[GeoView#How_to_get_the_HTML_kits_.3F| below]]
If both two kits are installed, webkit will be used.===== WebKit =====It's the future. Be aware, WebKit is always in development. I already test this with segmentation fault, ...
More and more projects are integrating webkit ...
==== Proxies ====Eg, epiphany states: I don't know how WebKit works at this level*http://blogs. I think it uses some configuration file or environment variablegnome.org/epiphany/2008/04/01/the-future-of-epiphany/
''I need help about thisWebKit uses the libsoup library for the proxy.''===== Gecko ( GtkMozEmbed ) =====
What will gtkmozembed be in the future ?
==== Proxies ====The embedding API of Gecko (GtkMozEmbed) has been unmaintained and stagnant for a long time. GtkMozEmbed is proxy aware. I implement implemented this and I use the http_proxy environment variable.
Authentication is allowed. The http_proxy format used is :
''http://[user:password@]proxy:port/''==== The maps providers proxies ====There are Most people don't need a lot proxy. The majority of providersus are connected directly to internet. Some are freeIn this case, forget all this.
By default, the provider is OSM ( OpenStreetMap )You need a proxy only if you installed one or if you depend on some internet providers.
This provider depends on You need to set the community and the maps are very light depending on the country. Nevertheless, the community made an extraordinary job since a few month. We can say OpenStreetMap is and will be the map for grampsenvironment variable http_proxy or use your desktop proxy configuration.
Openlayers is free too and uses by default OSM map.==== How to get the HTML kits ? ====A lot of private or non free maps It depends on OpenLayersthe distribution you're working on ! They are listed in reverse order.
The most interesting python-webkitgtk is the IGN ( Institut Géographique National Français ) which offers an old map of France ( about 1780 ) but this provider needs a key. I'll speek about keys lateralso called pywebkitgtk in some distributions.
You have Googlemaps, Yahoo! maps, Microsoft maps, ...===== debian =========== webkit ====== ''aptitude install python-webkit''====== gecko ====== ''aptitude install python-gnome2-extras'' or ''aptitude install python-gtkmozembed''
== mapstraction === fedora =========== webkit ======Like you can see, it's impossible to implement all providers maps. For this reason, some people created an api over all these providers api.You must use : WebKit-gtk
With only a few modification, you can use the map you want. And better! you can switch between the maps keeping the zoom and the centered position. ''yum install WebKit-gtk pywebkitgtk''
It's also in the development phase and is sometimes buggy.====== gecko ======
== The provider Key === MAC/OS X =====Gramps ====== webkit ======WebKit is not a web site. Keys are only for web site.In GeoView, I use a specific functionality : We are working the standard renderer on local file instead of urlOSX, so we donbut WebKitGtk doesn't need a keywork with the installed WebKit framework.some providers like IGN needs key even in this caseYou must build WebKitGtk or obtain it via Fink or MacPorts. So I can't use them. Why ?#Too complex Gtk-OSX provides a patch for final user'sbuilding WebKitGtk with quartz.#We need a key by providerIn these caseOnce WebKitGtk is built or installed, I hope you understand the choice is limited even is mapstraction can do morePyWebKitGtk installs and works well.=== Constraint ===We have no key, so we have a restricted access : About 10,000 to 15,000 requests by IP per day depending on the provider.gecko ======
What is a request ? As I understand with ===== mandriva =========== webkit ======for 2009.0 and 2009.1:Use the IGN ( OpenLayers ), a request is an imagepackage manager and install python-webkitgtk or : ''urpmi python-webkitgtk''====== gecko ======Seems not to work. You need several images for a viewCauses segmentation fault.
I think it is sufficient for the lambda genealogist.===== suse =========== webkit ======* libwebkit-1_0
== The proxies ==Everybody doesnI didn't test GeoView on suse or opensuse. I need a proxy. The majority of us are connected directly to internet. In this case, forget all thissome feedback.
You need a proxy only if you installed one or if you depend I found on some fai which provides oneexample in : ftp5.gwdg.de/pub/opensuse/repositories/home:/bmotmans/openSUSE_<VERSION>/<ARCH>/
== How to get Replace <VERSION> by the html kits ? ==It depends on the distribution fedora version you're working on ! They are listed in reverse orderuse. ie : Factory, 10.3, 1.0, ...
python-webkitgtk is also called pywebkitgtk=== ubuntu ======= webkit ====You needs libwebkit and python-webkitgtkReplace <ARCH> by i586, x86_64, ...
Add to the /etc/apt/sources.list :* pywebkit
# for pythonhttp://packages.opensuse-webkitgtkcommunity.org/index.jsp?searchTerm=pywebkit
deb http://ppa.launchpad.net/gwibber* pyton-team/ubuntu hardy mainwebkit
# for libwebkitOn OpenSUSE 11.3 that is the appropriate name.
deb http://ppa.launchpad.net/webkit-team/ubuntu hardy main====== gecko ======
It's from nightly builds, so it can crash.===== ubuntu =========== webkit ======
If you have some crash and want to ''aptitude install the working package, you can get libwebkitfrom the following url :python-webkit''
https://edge.launchpad.net/~stemp/+archive====== gecko ======
If you want gtkmozembed on ubuntu,
you must install : python-gnome2-extrasor python-gtkmozembed depending on you distrib version.  ''aptitude install python-gnome2-extras'' or ''aptitude install python-gtkmozembed'' ===== windows XP/Vista =========== webkit ====== * WebKitGTK is the port of the portable web rendering engine WebKit to the GTK+ platform on Windows. This zip file contains webkitgtk itself and all needed dynamic link libraryes (DLL). You will need [http://www.7-zip.org 7zip] to extract its contents ''This file is highly experimental and all functions may not work as expected!''** [http://www.gramps-project.org/wiki/images/d/d2/WebKitGTK-1.1.16.zip WebKitGTK-1.1.16.zip] * Update to version 1.1.23 (binary and devel files only)** [http://www.gramps-project.org/wiki/images/d/db/WebKitGTK-1.1.23-win32.zip WebKitGTK-1.1.23]  * [http://code.google.com/p/pywebkitgtk PyWebKitGtk] provide Python bindings to WebKitGTK** [http://www.gramps-project.org/wiki/images/4/4d/PyWebKitGTK-1.1.7.win32-py2.6.zip PyWebKitGTK-1.1.7.win32-py2.6.msi] [[All In One Gramps Software Bundle for Windows|Gramps AIO package]] contains WebKitGTK-1.2.5 and PyWebKitGTK-1.1.8 ===== ... =====Your distributions are welcomed ...=== The Geographic part ===This module is called geoview. It depends on the htmlrenderer module.===== In GRAMPS 3.1.x =====If you really are in 3.1.2 and greater, you only have the geoview module. The htmlrenderer is included in geoview.For installing the html renderer, you can see the documentation above. It is present as an experimental view you can activate. For GeoView to work you need to:# change the GRAMPS configuration file to list the view in the list of views# install the required backend so you can see webpages inside of GRAMPS.# set the GeoView Preferences# use the appropriate latidude and longitude format in your data (Note: the [[Place completion tool]] can look up latitude and longitude of the places defined in GRAMPS.) The first is simple to achieve. Start a text editor and go to your gramps home directory, and open the keys.ini file. Scoll down to the interface section, and look for the ''data-views'' variable. On a clean install of GRAMPS, this variable is normally: data-views=GrampletView,PersonView,RelationshipView,FamilyListView,PedigreeView,EventView,SourceView,PlaceView,MediaView,RepositoryView,NoteViewTo add GeoView, just add it to the back, so your configuration reads: data-views=GrampletView,PersonView,RelationshipView,FamilyListView,PedigreeView,EventView,SourceView,PlaceView,MediaView,RepositoryView,NoteView,GeoView That's it.  To install the backend, scroll down to [[GeoView#How_to_get_the_HTML_kits_.3F|the installation section]]. Finally, you need to set the Geoview Preferences: [[Image:GeoViewPreferences.png]]. Openlayers is free too and uses by default OSM map. A lot of private or non free maps depends on OpenLayers. The most interesting is the IGN ( Institut Géographique National Français )[http://www.geoportail.fr/visu2D.do?cg=djoxLjEqYzptZXRyb3BvbGUqY3Y6MS4wKnZ2OjEuMSp4eToyLjM0NTI3NDM5ODQwMTE4ODN8NDguODYwODMyNTU3MTczODgqczoxMCpwdjoxLjAqcDpkZWNvdXZlcnRlKmw6UGhvdG98fHwsU2NhbnwxfDEwMHwsQ2Fzc2luaXwxfHw%3D] which offers an old map of France ( about 1780 ) but this provider needs a key. I'll speak about keys later. Then you have Googlemaps, Yahoo! maps, Microsoft maps, ... ===== In GRAMPS 3.2 =====You don't need to set the providers. The first one is always OpenStreetMap and the alternate is GoogleMaps. ==== Supported longitude/latitude formats ====When you create/modify a place, the possible formats used for longitude/latitude are: * Floating point e.g. +12.0154 -124.3647 * Classic  e.g. 50°52'21.92"N 124°52'21.92"E The degree symbol can be either UTF-8 code c2b00a, UTF-8 code c2ba0a or the hash (#) character.The seconds symbol can be either one double quote (") character or two single quote (') characters. * Colon e.g. -50:52:21.92 124:52:21.92 * Modified GEDCOM e.g. 12.0154N 124.3647E ==== The maps providers ====There are a lot of providers. Some are free. By default, the provider GRAMPS uses is OSM ( OpenStreetMap ). As a free project, we find it our duty to first and foremost support another free initiative. OpenStreetMap depends on the community and the maps are very light depending on the country. Nevertheless, the community made an extraordinary job and the quality is improving rapidly. And you can [http://openstreetbugs.appspot.com/ help make it better]! We can say OpenStreetMap is and will be the map GRAMPS uses per default. ==== mapstraction ====Like you can see, it's impossible to implement all providers maps. For this reason, some people created an api over all these providers api. With only a few modification, you can use the map you want. And better! you can switch between the maps keeping the zoom and the centered position. For performances issues, I can confirm it takes approximately 30 seconds to view 1000 markers for openstreetmap or google.If you have 2000 markers, this time is about 2 times 30 seconds. For this, I limit one HTML page to 200 markers. If you have more than this limit, GRAMPS creates the necessary pages to see all your markers. During testing with a places database for France ( > 35000 markers ), I set the limit to 20 markers which permit to create 1760 pages without problems. So we can say we have an unlimited number of markers. Only the file system space will limit us. ==== The provider Key ====GRAMPS is not a web site. Keys are mostly only for web sites.In GeoView, I use a specific functionality : we are working on a local file instead of an url, so we normally don't need a key. However, some providers like IGN need a key even in those cases. So we can't use them. Why ?#To require a key would be too complex for the normal GRAMPS user#We need a key from the providerWe hope it is understood that our choice of maps is limited even if mapstraction can do more. ===== Constraint =====We have no key, so we have a restricted access : About 10,000 to 15,000 requests by IP per day depending on the provider. What is a request ? As I understand with the IGN ( OpenLayers ), a request is a tile ( an image ). You need several tiles for a view. I think it is sufficient for the lambda genealogist. ==== Creating new places from the Geography view ====You center the map for the place you want to create.You can use the double click for that.When you are sure the position is OK, click on the "+" button in the tools bar.Now, the place editor is opened. Enter all the field necessary for this new place then click on the OK button. That's all.==== Associate a new position to an already existing place ====You center the map for the place you want to modify like for creating a new place.When you are sure the position is OK, click on the "map" button in the tools near the "+" button described above.A places list is opened. Choose the place you want to modify then click on the OK button. You can use this method to modify the position you used in a prior creation.====Results==== <gallery>Image:Geoview1.png|Fig.1 All event places with coordinates for an individualImage:Geoview2.png|Fig.2 All individual's family places with coordinatesImage:Geoview3.png|Fig.3 All event places with coordinates on Family TreeImage:Geoview4.png|Fig.4 All places with coordinates on Family Tree</gallery> ==== If you get a crash when starting gramps ====It's probably a webkit problem.So, you have two possibilities :===== Remove the webkit rendering engine only =====Remove webkit and install gtkmozembed (gecko) is not already installed. See the specific package for your distribution.You'll have the gecko rendering.===== Remove all rendering engines =====Remove python-webkit and python-gtkmozembed. You'll never see geoview. See the specific packages for your distribution.
It's stable but install many gnome packages even if you are on a kde based distribution.==See also==* [[GeoViewHelp]] Addon
Please, don't troll ![[Category:GEPS|G]]=== suse ===[[Category:Plugins]]==== webkit ====[[Category:Developers/General]]==== gecko ======= mandriva ======= webkit ======== gecko ======= fedora ======= webkit ======== gecko ======= debian ======= webkit ======== gecko ====== ... ==Your modifications are welcomed ...[[Category:Views|G]]
2,186
edits

Navigation menu