[[projects:projects]]:geo

====== geo ======

===== User Guide =====

https://geo.voyc.com

World map of history \\
World map of geopolitics \\
Geo Sketch \\

==== Credits ====

[[Credits]]\\
https://cartographyvectors.com/map/1224-caspian-sea


==== Four Tools ====

These four tools determine the operation of the mouse and of a single finger.

{{::movetool_black_24.png|}} Move - click, tap, or drag to move the map

Point - click, tap, or drag highlight and identify a feature on the map

Sketch - click, tap, or drag to sketch a new feature or edit an existing one 

Measure - click or tap twice to measure the distance between two points


You can also move the map by dragging with two fingers, and by using the arrow keys.


Move in Move Mode 
    drag the mouse or one finger
    click or tap to jump to a point
        
Move in any mode
    drag the middle mouse button        
    drag two fingers
    right, left, up, down arrow keys

Zoom 
    mouse wheel
    shift-up and shift-down arrow keys
    two finger pinch in and out
    zoomer tool        

Rotate the globe on the z-axis
    shift-right and shift-up arrow keys        

Point 
    shift-click the mouse

double click
double tap


Sketch - drag to draw a shape on the map

Point - click only, highlight and identify an object on the map

Measure - two mouse clicks, measure the distance between the two points

==== Controls ====

Zoomer 

Time Slider

Globe/Mercator

Search

Where Am I - lower-left corner, lat/long coordinates of mouse

==== Menus ====

Main Menu

Tools

Layers

User

==== Layers ====

=== Custom Layers ===


===== Developer Guide =====

Source code: https://gitlab.com/voyc/geo

geo replaces global.  Global used the google map api.  Geo uses our own javascript, originally copied from the D3 project on github.

Up until June 2026, global cum geo was the home page for voyc.com, and that was thought of as our primary product.

---------------

The following is copied from projects:voyc:voyc.txt

[[projects:voyc:Design Notes]]

[[projects:voyc:Data Origin]]

[[projects:voyc:Data Analysis]]

[[projects:voyc:Data Extraction]]

[[projects:voyc:ToDo]]

[[projects:voyc:Exaggerated Typography Maps]]

[[projects:voyc:Map Projections]]

[[projects:voyc:Zoom Level]]

[[projects:voyc:GeoIterator]]

[[projects:voyc:Mercator switch]]

[[projects:voyc:Straddle Antimeridian]]

=== Spreadsheets ===

[[https://docs.google.com/spreadsheets/d/1Awik0YO8_AF4qbHn_Z4mJF2ILMT7bNyWxkIqfEUh4m4/edit?usp=sharing | cover]]

[[https://docs.google.com/spreadsheets/d/1Hs1h9R91J8e3biNyIzN-aX_iER-cJ1zTMMGI4BeC-IA/edit#gid=1706980549 | projects]]
-----------------

==== Test Suite ====

==== Todo ====

=== Todo Data ===

sketch_world landmarks sheet: https://docs.google.com/spreadsheets/d/1tGFLZGoImvcf8dj5HsG48Xsm_phn2BYVDNbd-ksg_W8/edit

Cities in India missing.  Where is Calcutta?  and Delhi?  

=== Todo Features ===

Add an Aitoff projection in addition to orthogonal and mercatur.

Add a pencil sketch drawing mode.

Add a drawing mode to draw a great circle on two points.  On each of the three projections.

=== Todo Bugs ===

Main menu, remove link to videos.

Main menu, change X logo from twitter bird to one downloaded from x-logo.svg downloaded from 
https://about.x.com/en/who-we-are/brand-toolkit

Allow the layer menu to scroll.

Choose the default layers and settings, establish them at startup, add a Factory Reset button to re-establish those default layers and settings.  Consider the following layers.
  * grid
  * pencil sketch - layer 1
  * pencil sketch - layer 2
  * pencil sketch - layer 3
  * pen final

Add a setting: Layer List, the value choices are streamlined or advanced.

Draw the layer list differently depending on the setting as follows.
  * streamlined layer list
    * no palettes
    * dropdown menu for cover
      * hi res, 
      * lo res, 
      * fast: oceans, land, cover, desert, mountains 
      * none
    * combine lakes and rivers and deltas
    * make viewport always on (only relevant to zoomed out mercator)
  * advanced layer list
    * keep the cover dropdown, when fast is selected, show layers individually
    * implement palette

Temporarily disable and hide the option for hi res.
  * The loading... panel will no longer show because we are no longer loading the hi res data.

Fix browser-specific bugs:
  * Linux Brave
    * zoom control is vertical.
    * history control is ok
  * Linux Firefox
    * zoom control is horizontal.
    * history control is missing
    * loading panel too small, get text wrap
    * cursor coordinates panel too small, get text overflow  *
  * Android Brave
    * history control is too wide, pushes zoom control off screen
    * two-fngers down turns on both zoom and tilt.
    * two-fingers up does not turn off zoom or tilt.  It needs a two finger tap to end zoom mode, so subsequent one-finger moves seem haywire. Maybe we don't want tilt at all.  more harm than good.  or make it a special option.
  * Android Chrome
    * bottom row, only layer and projection buttons, no history, no zoom, no cursor coordinates
    * two-fingers up works fine

for countries, design a color-coding palette for orgs
  * more treaty organizations: brics, asean, ocgfc, global south
  * also geo regions

Show the time scrollbar only when a historically relevant layer is active.

==== Version History ====
v0.0.0 2026 Jun 6 First release.