Template:Zh OpenStreetMap Description Utility

From Documentation
Revision as of 18:38, 17 December 2019 by Admin (talk | contribs) (→‎Utilities)
Jump to navigation Jump to search

Utilities


Import CSV

Import Zh YandexMap

If extension is not installed - buttons for this extension is disabled.

Today you can:

  • import data from Zh YandexMap extension
    • import Groups
    • import Placemarks
  • check log for last import process

In future will be added

  • pre-import check (exists categories, groups and tags)
  • import tags for placemarks

Due to complex process creation of category - automatic creation of categories is not supported. Only check.

For correct process execution do not import data parallelly, ie in different windows (tabs). Just do it in one precess.

Data loading by Addition rule, it is not update exist data.

It means:

- group will be the same if it has THE SAME TITLE

- category will be the same if it has THE SAME PATH, ie it alias and aliases of all its parents are the same

- placemark will be the same if it has THE SAME TITLE and BELONGS to the destination MAP

If you close browser on middle of process - you can continue loading (but save log before new process).

When you start to continue import process - the same map objects will be skipped and you'll get only new data.

When process is done you'll get statistics window

Here main screen

Toolbar buttons:

  • Close - close and return to Utilities
  • Import groups - automatic load groups
  • Import placemarks - automatic load placemarks
  • Log - check process log
  • Clear Log - clear process log


Lets check how it works

For example we have

I created map in Zh YandexMap


New group


New category


I created placemarks assigned to group and category, and without it

Go to Zh OpenStreetMap


Create map

As you can see group Bank doesn't exist

And category doesn't exist too.

For correct loading placemarks you need to have groups and categories in extension. If it doesn't exist you'll get warnings in process log.

You can automatically load groups, but categories - no. You need to add it manually.

In next steps we will load groups and placemarks. And we will get placemarks with groups but without categories (I didn't enter it).

Go to import screen

Press Import groups

Press Import button


You can see we import our group


and result


check our log

it is empty

Lets import placemarks


Press Import placemarks


Select our source and destination maps

Press Import button


You can see we import our placemarks

It means we loaded 6 placemarks and had some warnings


and result

As you can see placemarks have group attribute


Check log

Log is common log for import

You can see 5 fields, lets explain on our example, import placemarks with category, which doesn't exist:

  • Import object - which map object will be process, in our case Placemark.
  • Error type - what error is occured, in our case Category not found. Check images with data for details above.
  • Target ID - distination object ID, in our case new placemark ID (ID = 104). Check images with data for details above.
  • Source ID - source object ID, in our case placemark ID (ID = 48) from source extension. Check images with data for details above.
  • Source Reference Object ID - reference object ID (category ID = 14), which is not exist in destination extension.

As you can see our problem is occurred for placemark Marker 7, which has in source extension (Zh YandexMap) ID = 48 and assigned to category x8 with ID = 14


I can clear log by press Clear Log or it will automatically be cleared by next precess


Lets try to import groups again

As you can see there is no any data to load

Import Zh GoogleMap

If extension is not installed - buttons for this extension is disabled.

Today you can:

  • import data from Zh GoogleMap extension
    • import Groups
    • import Placemarks
  • check log for last import process

In future will be added

  • pre-import check (exists categories, groups and tags)
  • import tags for placemarks

Due to complex process creation of category - automatic creation of categories is not supported. Only check.

For correct process execution do not import data parallelly, ie in different windows (tabs). Just do it in one precess.

Data loading by Addition rule, it is not update exist data.

It means:

- group will be the same if it has THE SAME TITLE

- category will be the same if it has THE SAME PATH, ie it alias and aliases of all its parents are the same

- placemark will be the same if it has THE SAME TITLE and BELONGS to the destination MAP

If you close browser on middle of process - you can continue loading (but save log before new process).

When you start to continue import process - the same map objects will be skipped and you'll get only new data.

When process is done you'll get statistics window

Here main screen

Toolbar buttons:

  • Close - close and return to Utilities
  • Import groups - automatic load groups
  • Import placemarks - automatic load placemarks
  • Log - check process log
  • Clear Log - clear process log


Lets check how it works

For example we have

I created map in Zh GoogleMap


New group


New category


I created placemarks assigned to group and category, and without it

Go to Zh OpenStreetMap


Create map

As you can see group Bank doesn't exist

And category doesn't exist too.

For correct loading placemarks you need to have groups and categories in extension. If it doesn't exist you'll get warnings in process log.

You can automatically load groups, but categories - no. You need to add it manually.

In next steps we will load groups and placemarks. And we will get placemarks with groups but without categories (I didn't enter it).

Go to import screen

Press Import groups

Press Import button


You can see we import our group


and result


check our log

it is empty

Lets import placemarks


Press Import placemarks


Select our source and destination maps

Press Import button


You can see we import our placemarks

It means we loaded 6 placemarks and had some warnings


and result

As you can see placemarks have group attribute


Check log

Log is common log for import

You can see 5 fields, lets explain on our example, import placemarks with category, which doesn't exist:

  • Import object - which map object will be process, in our case Placemark.
  • Error type - what error is occured, in our case Category not found. Check images with data for details above.
  • Target ID - distination object ID, in our case new placemark ID (ID = 110). Check images with data for details above.
  • Source ID - source object ID, in our case placemark ID (ID = 97) from source extension. Check images with data for details above.
  • Source Reference Object ID - reference object ID (category ID = 15), which is not exist in destination extension.

As you can see our problem is occurred for placemark Marker 6, which has in source extension (Zh GoogleMap) ID = 97 and assigned to category x8 with ID = 15


I can clear log by press Clear Log or it will automatically be cleared by next precess


Lets try to import groups again

As you can see there is no any data to load