GeoCacher - Инструкция пользователя

Последнее изменение: 02/06/2020 13:36:32
Страница загрузки и история изменений GeoCacher-а

Быстрый старт

Image:ie_proxy_conf_1.png

В появившемся окне необходимо отметить пункт "Использовать прокси-сервер для этого подключения (не применяется для других подключений)", и указать Адрес: 127.0.0.1 Порт: 8081 (адрес - ip компьютера, на котором запущен GeoCacher, порт - дефолтный порт GeoCachera). Если на компьютере используется несколько соединений с Интернет, то данные настройки нужно применить ко всем соединениям, по очереди.

Image:ie_proxy_conf_2.png

Так же, если планируется использовать локальный клиент GE.LOCAL, для просмотра кэша GC, при отсутствии соединений с Интернетом, на вкладке "Подключения" необходимо нажать "Настройка сети", в появившемся окне отметить "Использовать прокси-сервер для локальных подключений (не используется для удалённых или VPN подключений)" и так же ввести Адрес и Порт.

Image:ie_proxy_conf_3.png

Важно: Все настройки IE необходимо производить при закрытом GE (настройки вступают в силу после перезапуска GE).

Склеенные запросы

Склеенным, называется запрос вида:

  http://kh.google.com/flatfile?f1-002-i.280+f1-012-i.212+q2-0-q.281&v=1

В приведенном запросе объединены 3 файла: f1-002-i.280, f1-012-i.212, q2-0-q.281. Данный запрос эквивалентен 3-м одиночным запросам:

  http://kh.google.com/flatfile?f1-002-i.280
  http://kh.google.com/flatfile?f1-012-i.212
  http://kh.google.com/flatfile?q2-0-q.281

GeoCacher распознаёт такие запросы, производит поиск в кэше каждого из запрошенных тайлов в отдельности, а затем формирует новый запрос, из которого выбрасывается упоминание тайла(ов) найденных в кэше. После получения ответа сервера, GeoCacher сохраняет каждый тайл в отдельности (разрезает тело ответа на тайлы) и собирает свой ответ, в который включаются все тайлы: как те, что были в кэше, так и те, что были получены от сервера, запрашиваемые клиентом.

Подробнее о структуре склеенных запросов


Цвета иконок в трее

Для информирования о различных режимах работы и состояниях GeoCacher-а, в трее используются иконки 3-х цветов:

Image:GeoCacher_BlackTrayIcon.png чёрная - бездействие (нормальный режим работы);
Image:GeoCacher_BlueTrayIcon.png синяя - бездействие (ограниченный режим работы: включены опции "Только из кэша" или "Любая версия");
Image:GeoCacher_GreenTrayIcon.png зелёная - обработка запроса, в любом режиме работы.

Описание пунктов меню трея

  [export.netOptions.maxRequestsPerQuery] 10
Включать или отключать данный пункт меню следует ДО запуска клиента GE (т.е. перед тем, как клиенту будет передан файл dbRoot.v5). Если всё работает без каких либо замечаний, то отключать склеенные запросы не рекомендуется.
   <etTemplate> [<etProviderInfo>]
       {
           <etInt>     [id]            -1
           <etString>  [copyright]     ""
           <etInt>     [copyrightY]    -1
           <etBool>    [report]        false
           <etInt>     [copyrightPri]  256
       } 
После чего, клиент будет считать что в переданном dbRoot.v5 информация о правообладателях отсутствует. Однако, если в кэше у клиента GE уже имеются файлы dbRoot.v5 (передаются при каждом сеансе и соответственно, сохраняются в кэш), то клиент будет частично, либо полностью отображать копирайты, беря информацию из старых dbRoot.v5.
Важно: Если используемый клиент GE "пропатчен" на предмет неотображения копирайтов, то включение пункта "Удалять копирайты GE" приведет к краху клиента.
Важно: При отключённом пункте меню "Только из кэша", клиенту GE.LOCAL разрешена работа в онлайн (GC автоматически корректирует URL и заголовки запросов, заменяя подстроки hoohle на google). НО, если клиент GE.LOCAL был запущен при включённом пункте "Только из кэша" (т.е. была оффлайн авторизация), то отключать данный пункт следует только ПОСЛЕ закрытия GE.LOCAL (иначе на сервер гугла пойдут ошибочные запросы).
Функция работает для заданного диапазона уровней зума (выбирается из списка). Т.о. включение данной опции, к примеру, на z14, будет означать, что на уровнях зума от 1 до 14, при отсутствии тайла в кэше, будет отдан тайл любой версии, а начиная с зума 15 будут отдаваться тайлы только запрашиваемой версии.
Приписка "[HDD]" говорит о том, что функция работает без использования БД, и для того, что бы найти тайл "любой версии" производится поиск в соответствующих папках.
При сортировке тайлового кэша, отличной от дефолтной (а именно, если сделана сортировка тайлов разных версий по разным папкам), для правильной работы данной функции требуется дополнительная настройка: в файле TileCacheRE.ini в секции "folders", необходимо прописать пути ко всем папкам, в корне которых лежат папки с номерами версий.
При совместном включении опций "Любая версия [HDD]" и "Только из кэша" (работа в off-line), данная функция работает для всех типов тайлов, НО, что очень важно, после использования совместного включения данных опций, следует удалить (либо никогда не использовать для работы в on-line) полученный кэш GE, поскольку клиент начнёт выдавать неверные запросы серверу (запросы, на тайлы с устаревшей версией). Если же режим "Только из кэша" отключён (т.е. идёт работа в on-line), то функция работает для всех типов тайлов, кроме тайлов qtree (q2-name-q.xxx и qp-name-q.xxx) и накапливаемый при этом кэш GE, можно и в дальнейшем использовать для работы в on-line.

На клик левой клавишей мыши по иконке в трее, назначено действие: закрыть GeoCacher.


GUI - графический интерфейс для GC

Внешний вид GUI GUI представляет собой сетевую утилиту (файл GeoGui.exe), которая умеет получать статистку от кэшера, а так же умеет изменять все его настройки. GUI и кэшер абсолютно независимые приложения, и открытие/закрытие одного из них никак не влияет на работу другого (если будет закрыт кэшер, то GUI будет "ждать" его, и как только тот будет запущен, сразу же возобновит показ статистики). GUI и кэшер могут физически находится на разных компьютерах, при этом в настройках GUI нужно будет указать ip компьютера, где запущен кэшер.

Полноразмерные скриншоты вкладок GUI: Монитор, Настройки, Статистика.


Назначение папок GC

Перечень папок в корне программы, при дефолтных настройках GC:


Структура кэша

У GC есть 2 типа кэша: тайловый и kml кэш. В kml кэш сохраняются kml-слои GE, а так же все url, содержащие подстроку google.com.
Дефолтная структура кэша:

Далее, тайлы отсортированы таким образом, чтобы в каждой папке находилось не более 1024 папки или тайла. Так же, тайлы qtree разных версий отсортированы по разным папкам, тайлы слоёв - по папкам с номером слоя, а тайлы исторических снимков - по папкам с датой снимка.

 .\cache\Tiles\Earth\Images\z22\1884\x1929480\1216\f1-0122013222330133001003-i.160  
 
 z22      - уровень зума, zoom = 22
 1884     - Xi - делитель по X, Xi = X/1024
 x1929480 - X - номер тайла по оси X, X = 1929480
 1216     - Yi - делитель по Y, Yi = Y/1024  

Аналогочно сортируется рельеф:

 .\cache\Tiles\Earth\Terrains\z21\549\x563003\362\f1c-020301302022100111022-t.207

Особенность сортировки исторических снимков:

 .\cache\Tiles\History\Images\f4b9f\z4\0\x1\0\f1-0302-i.33-f4b9f
 f4b9f    - дата исторического снимка

Особенность сортировки слоёв:

 .\cache\Tiles\Earth\Layers\5212\z7\0\x51\0\f1c-0210322-d.5212.281
 5212     - номер слоя

Аналогично сортируются текстуры:

 .\cache\Tiles\Earth\Textures\50050\z18\74\x76583\44\f1-020310231130203122-d.50050.235
 50050    - номер слоя

Особенность сортировки деревьв:

 .\cache\Tiles\Earth\Qtrees\282\z20\299\x306519\211\q2-02002023110131020211-q.282
 282      - версия q-тайла

Важно: Сортировка тайлового кэша может быть настроена каждым пользователем индивидуально. Настройка осуществляется правкой файла: options/TileCacheRE.ini