Changes

Jump to: navigation, search

GeoView

5,639 bytes added, 22:52, 30 January 2022
m
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]]}}
{{man warn|Instructions for the older GeoView addon that was based on webkit/gtkmozembed}} '''All we need to understand and test GeoView.'''
== 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.
How to do this easily and with the minimum of software to install ?== The future ==
GeoView For approximatively three years, geoview is one solutionbased on html technology using webkit or gtkmozembed.We have some problems depending on the distribution, the webkit version, ... : crashes, messages on console, ...
== The html kits ==We can use webkit or gtkmozembed mecanism for rendering the map is asynchronous and difficult to view HTML pages. If no one is installed, youmanage : the renderer and gramps are two different things which don'll never see GeoViewt easily communicate.
If the two kits are installedSo, webkit will be usedI am working on a new map renderer since some month now.
For web browsingIf you are impatient, we need to be connected to the network.go there : [[Geography]]
Even if you have a HTML kit installed, you can always say ==GeoView is divided in two parts : ==This module is now in two parts in 3.2. I don't mind ! I don't want ll try to explain how to install them and how to see 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 HtmlViewWeb view.
For How to do this, you can disallow Geoview 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 smooth result. Try eg Google maps in the Internet Maps preferences tabyour browser to see if your internet connection is sufficiently fast.
GRAMPS can use two different kind of engines, webkit or gtkmozembed, to view HTML pages. If they are not installed, you'll never see [[Geography]] and the Web 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.
More and more projects are integrating webkit ...
 The reason why for Eg, epiphany states:
*http://blogs.gnome.org/epiphany/2008/04/01/the-future-of-epiphany/
==== Proxies ====WebKit uses the libsoup library. You need for the environment variable http_proxyproxy===== Gecko ( GtkMozEmbed ) =====
What will gtkmozembed be in the future ?
The embedding API of Gecko (GtkMozEmbed) has been unmaintained and stagnant for a long time.
==== Proxies ====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 proxies ====Most people don't need a proxy. The majority of us are connected directly to internet. In this case, forget all this. You need a proxy only if you installed one or if you depend on some internet providers. You need to set the environment variable http_proxy or use your desktop proxy configuration. ==== How to get the HTML kits ? ====It depends on the distribution you're working on ! They are listed in reverse order. python-webkitgtk is also called pywebkitgtk in some distributions. ===== debian =========== webkit ====== ''aptitude install python-webkit''====== gecko ====== ''aptitude install python-gnome2-extras'' or ''aptitude install python-gtkmozembed'' ===== fedora =========== webkit ======You must use : WebKit-gtk  ''yum install WebKit-gtk pywebkitgtk'' ====== gecko ====== ===== MAC/OS X =========== webkit ======WebKit is the standard renderer on OSX, but WebKitGtk doesn't work with the installed WebKit framework. You must build WebKitGtk or obtain it via Fink or MacPorts. Gtk-OSX provides a patch for building WebKitGtk with quartz. Once WebKitGtk is built or installed, PyWebKitGtk installs and works well.====== gecko ====== ===== mandriva =========== webkit ======for 2009.0 and 2009.1:Use the package manager and install python-webkitgtk or : ''urpmi python-webkitgtk''====== gecko ======Seems not to work. Causes segmentation fault. ===== suse =========== webkit ======* libwebkit-1_0 I didn't test GeoView on suse or opensuse. I need some feedback. I found on example in : ftp5.gwdg.de/pub/opensuse/repositories/home:/bmotmans/openSUSE_<VERSION>/<ARCH>/ Replace <VERSION> by the fedora version you use. ie : Factory, 10.3, 1.0, ... Replace <ARCH> by i586, x86_64, ... * pywebkit http://packages.opensuse-community.org/index.jsp?searchTerm=pywebkit * pyton-webkit On OpenSUSE 11.3 that is the appropriate name. ====== gecko ====== ===== ubuntu =========== webkit ======  ''aptitude install python-webkit'' ====== gecko ======If you want gtkmozembed on ubuntu, you must install : python-gnome2-extras or python-gtkmozembed depending on you distrib version.  ''aptitude install python-gnome2-extras'' or ''aptitude install python-gtkmozembed'' ===== windows XP/Vista =========== webkit ======
To confirm * 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: We need //www.7-zip.org 7zip] to use gnomeextract its contents ''This file is highly experimental and all functions may not work as expected!''** [http://www.gramps-control-center to set the proxyproject.== Supported longitudeorg/wiki/images/latitude formats ==When you created/modify a place, the possible formats used for longituded2/latitude are :WebKitGTK-1.1.16.zip WebKitGTK-1.1.16.zip]
'D* Update to version 1.D4' : degree notation, 4 decimals eg +12.0154 , -124.3647 'D1.D8' : degree notation, 8 decimals 23 (precision like ISO-DMSbinary and devel files only) eg +12.01543265 , -124.36473268 'DEG' ** [http: degree, minutes, seconds notation eg 50°52'21//www.92"N , 124°52'21.92"E ° has UTFgramps-8 code c2b00a or N 50º52'21.92" , E 124º52'21project.92" º has UTForg/wiki/images/d/db/WebKitGTK-8 code c2ba0a 'DEG-:' : degree, minutes, seconds notation with : eg -50:52:21.92 , 124:52:21.92 'ISO-D' : ISO 6709 degree notation i.e. ±DD1.DDDD±DDD1.DDDD 'ISO23-DM' : ISO 6709 degree, minutes notation i.ewin32. ±DDMM.MMM±DDDMM.MMM 'ISOzip WebKitGTK-DMS' : ISO 6709 degree, minutes, seconds notation i.e. ±DDMMSS1.SS±DDDMMSS1.SS23]
== The maps providers ==* [http://code.google.com/p/pywebkitgtk PyWebKitGtk] provide Python bindings to WebKitGTKThere are a lot of providers** [http://www.gramps-project.org/wiki/images/4/4d/PyWebKitGTK-1.1.7.win32-py2.6.zip PyWebKitGTK-1.1.7.win32-py2. Some are free6.msi]
By default, the provider is OSM ( OpenStreetMap )[[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 provider module is called geoview. It depends on the community and the maps htmlrenderer module.===== In GRAMPS 3.1.x =====If you really are very light depending on the countryin 3.1. Nevertheless2 and greater, you only have the community made an extraordinary job since a few monthgeoview module. The htmlrenderer is included in geoview. We For installing the html renderer, you can say OpenStreetMap is and will be see the map for grampsdocumentation above.
Openlayers It is free too and uses by default OSM mappresent 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.A lot # set the GeoView Preferences# use the appropriate latidude and longitude format in your data (Note: the [[Addon:Place completion tool]] can look up latitude and longitude of private or non free maps depends on OpenLayersthe places defined in GRAMPS.)
The most interesting first is simple to achieve. Start a text editor and go to your gramps home directory, and open the IGN ( Institut Géographique National Français )[http://wwwkeys.geoportailini file.fr/visu2DScoll down to the interface section, and look for the ''data-views'' variable.do?cg=djoxLjEqYzptZXRyb3BvbGUqY3Y6MS4wKnZ2OjEuMSp4eToyLjM0NTI3NDM5ODQwMTE4ODN8NDguODYwODMyNTU3MTczODgqczoxMCpwdjoxLjAqcDpkZWNvdXZlcnRlKmw6UGhvdG98fHwsU2NhbnwxfDEwMHwsQ2Fzc2luaXwxfHw%3D] which offers an old map On a clean install of France ( about 1780 ) but GRAMPS, this provider needs a key. I'll speak about keys later.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
You have Googlemaps, Yahoo! maps, Microsoft maps, ..That's it.
== mapstraction ==Like you can seeTo install the backend, it's impossible scroll down to implement all providers maps[[GeoView#How_to_get_the_HTML_kits_. For this reason, some people created an api over all these providers api3F|the installation section]].
With only a few modificationFinally, you can use need to set the map you want. And better! you can switch between the maps keeping the zoom and the centered position.Geoview Preferences:
It's also in the development phase and is sometimes buggy[[Image:GeoViewPreferences.png]].
For performances issues, I can confirm it takes approximately 30 seconds to view 1000 markers for openstreetmap Openlayers is free too and uses by default OSM map. A lot of private or google.If you have 2000 markers, this time is about 2 times 30 secondsnon free maps depends on OpenLayers.
For 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, I limit one HTML page to 200 markersprovider needs a key. I you have more than this limit, I create the necessary pages to see all your markers'll speak about keys later.
During testing with a places database for France ( > 35000 markers )Then you have Googlemaps, Yahoo! maps, Microsoft maps, I ... ===== In GRAMPS 3.2 =====You don't need to set the limit to 20 markers which permit to create 1760 pages without problems. So we can say we have an unlimited number of markersproviders. Only The first one is always OpenStreetMap and the file system space will limit usalternate is GoogleMaps.
== The provider Key == Supported longitude/latitude formats ====GRAMPS is not When you create/modify a web site. Keys place, the possible formats used for longitude/latitude are only for web sites.In GeoView, I use a specific functionality : We are working on local file instead of url, so we don't need a key.
Some providers like IGN needs key even in this case. So I can't use them. Why ?#Too complex for final user's.#We need a key by providerIn these case, I hope you understand the choice is limited even is mapstraction can do more.* Floating point
=== 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 providere.g. +12.0154 -124.3647
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.* Classic
I think it is sufficient for the lambda genealogiste.g. 50°52'21.92"N 124°52'21.92"E
== The proxies ==degree symbol can be either UTF-8 code c2b00a, UTF-8 code c2ba0a or the hash (#) character.Everybody doesnThe seconds symbol can be either one double quote (") character or two single quote ('t need a proxy. The majority of us are connected directly to internet. In this case, forget all this) characters.
You need a proxy only if you installed one or if you depend on some internet providers.* Colon
== How to get the HTML kits ? ==It depends on the distribution you're working on ! They are listed in reverse ordere.g. -50:52:21.92 124:52:21.92
python-webkitgtk is also called pywebkitgtk=== ubuntu ======= webkit ====You needs libwebkit and python-webkitgtk.* Modified GEDCOM
Add to the /etc/apt/sourcese.list :g. 12.0154N 124.3647E
# for python-webkitgtk==== The maps providers ==== deb http://ppaThere are a lot of providers.launchpadSome are free.net/gwibber-team/ubuntu hardy main # for libwebkit deb http://ppa.launchpad.net/webkit-team/ubuntu hardy main
It's from nightly buildsBy default, so the provider GRAMPS uses is OSM ( OpenStreetMap ). As a free project, we find it can crashour duty to first and foremost support another free initiative.
If you have some crash OpenStreetMap depends on the community and want to install the working packagemaps are very light depending on the country. Nevertheless, the community made an extraordinary job and the quality is improving rapidly. And you can get libwebkitfrom [http://openstreetbugs.appspot.com/ help make it better]! We can say OpenStreetMap is and will be the following url :map GRAMPS uses per default.
https://edge.launchpad.net/~stemp/+archive==== gecko mapstraction ====If Like you want gtkmozembed on ubuntucan see, it's impossible to implement all providers maps. For this reason, you must install : python-gnome2-extrassome people created an api over all these providers api.
It's stable but install many gnome packages even if With only a few modification, you can use the map you want. And better! you are on a KDE based distributioncan switch between the maps keeping the zoom and the centered position.
PleaseFor performances issues, don't troll !I can confirm it takes approximately 30 seconds to view 1000 markers for openstreetmap or google.=== suse ======= webkit ====* libwebkit-1_0If you have 2000 markers, this time is about 2 times 30 seconds.
For this, I didn't test GeoView on suse or opensuselimit one HTML page to 200 markers. I need some feedbackIf 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 found on example in : ftp5set the limit to 20 markers which permit to create 1760 pages without problems. So we can say we have an unlimited number of markers.gwdgOnly the file system space will limit us.de/pub/opensuse/repositories/home:/bmotmans/openSUSE_<VERSION>/<ARCH>/
Replace <VERSION> by the fedora version you use==== The provider Key ====GRAMPS is not a web site. ie : Factory, 10 Keys are mostly only for web sites.3In GeoView, 1.0I use a specific functionality : we are working on a local file instead of an url, ..so we normally don't need a key.
Replace <ARCH> by i586, x86_64However, 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.
* pywebkit===== 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.
http://packagesWhat is a request ? As I understand with the IGN ( OpenLayers ), a request is a tile ( an image ).opensuse-communityYou need several tiles for a view.org/index.jsp?searchTerm=pywebkit
==== gecko ======= mandriva ======= webkit ======== gecko ======= fedora ======= webkit ====You must use : WebKit-gtkI think it is sufficient for the lambda genealogist.
yum install WebKit-gtk pywebkitgtk==== 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.==== gecko Results====
=== debian ===<gallery>==== webkit ====Image:Geoview1.png|Fig.1 All event places with coordinates for an individualThis is the same packager for ubuntu and debian, so go to the ubuntu paragraphImage:Geoview2.png|Fig.2 All individual's family places with coordinates==== gecko ====Image:Geoview3.png|Fig.3 All event places with coordinates on Family Treeinstall the python-gtkmozembed packageImage:Geoview4.png|Fig.4 All places with coordinates on Family Tree=== windows XP</Vista ===Perhaps the following link can help windows developers :gallery>
http==== If you get a crash when starting gramps ====It's probably a webkit problem.So, you have two possibilities ://priscimon===== Remove the webkit rendering engine only =====Remove webkit and install gtkmozembed (gecko) is not already installed.com/blog/2008/06/04/four-easy-steps-to-runningSee the specific package for your distribution.You'll have the gecko rendering.===== Remove all rendering engines =====Remove python-webkitand python-on-windows/gtkmozembed. You'll never see geoview. See the specific packages for your distribution.
=== MAC/OS X ======= webkit ====This is standard on MAC. Can someone confirm this.Is there a python-webkit package on MAC ?==== gecko ====== ... See also==Your modifications are welcomed ...* [[GeoViewHelp]] Addon
[[Category:GEPS|G]]
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Views|G]]

Navigation menu