Display the actual configuration:
When you create a batch job, a default configuration will be added, this can be changed by the following paramter.
To view the configuration settings for the batch job, you must call the action configure with the a request-Id or batch-job-name:
action=configure
Example:
https://maps1.locr.com/batch-processing/job_v2.php?action=configure&request_id=<RequestId>
Change the configuration:
To change the configuration use the following parameter. Geocoding:All addresses will be geocoded and a position (latitude/longitude) will be added to the database. In addition, each position is assigned an accuracy level, which is the quality feature of the addresses, i.e. how exactly the position matches the specified address.
There are 6 levels:| 10 | manual | Position was specified manually. | | 8 | house | Position matches the address. | | 6 | street | Position represents the center of the specified street.
| | 5 | postal | Position is the center of the specified postal code area.
| | 4 | city | Position is the center of the specified city name, if a city name is more frequent in a country, it cannot be guaranteed that this is the specified city. (Do not use if possible!)
| | |
| No position, because addresses were not found!
|
Depending on the given values only those addresses will be used for the project which have a higher quality value than the set one! The default settings are postal code for customer addresses and house accuracy for destination addresses!
Bsp.:
https://batch.locr.com/job_v2.php?action=configure&request_id=<request_id>&min_customer_accuracy_to_use=<accuracy>&min_shop_accuracy_to_use=<accuracy> <accuracy>-Werte: 10 (manual), 8 (house), 6 (street), 5 (postal), 4 (city)
Routing
Type of the route:
There are different types of routings that can be setted by routing_type. For example you can choose to use the fastest or the shortest route.
routing_type=<F/E/S/N/A/I/M/P>
Possible parameter:
- F (fast) default
- E (easy), S (short)
- N (no freeways)
- A (avoid freeways)
- I (ignore pipes)
- M (more freeways)
- P
(pedestrian)
Example:
https://maps1.locr.com/batch-processing/job_v2.php?action=configure&request_id=<RequestId>&routing_type=F
More Routes on NAVImaps (max. 5 routes): (default: 1)
Up to 5 routes can be drawn into NAVImaps.
routing_max_shops_count=<1-5>
Max. Distance: (default: ∞)
Specifying the max. Distance to the destination.
routing_max_shops_distance=<int>
Unit: (default: m)
Unit in which the distance is specified.
routing_max_shops_distance_unit=<m|km|mi|ft>
Design of maps
Size of maps
First the unit for maps must be specified, after that the size for the maps must be defined.
Map size:
- map_size_width
- map_size_height
Or in one Parameter:
- map_size
Example: 21x14.8 (Width + Height)
Map unit:
- map_size_unit
Possible parameter: px, cm (default), inch
Border:
- map_border_left, map_border_right, map_border_top, map_border_bottom
Figure of the route (Color/width/transparency)
- routing_color
Possible parameter: AQ, BK, BL, FU, GN, GR, LI, MR, NA, OL, PU, RD, SI, TE, WH, YE (default: BK)
[Color list]
- routing_width
Possible parameter: 0-100 (default: 5)
- routing_transparency
Possible parameter: 0,20,40,60,80
Icon selection (start/finish)
- customer_icon_name [Icons Selection]
- customer_icon_color
Possible parameter: AQ, BK, BL, FU, GN, GR, LI, MR, NA, OL, PU, RD, SI, TE, WH, YE (default: BK)
[Color list]
Size of an icon (start/finish)- customer_icon_size=<value>
shop_icon_size=<value>
<value> can be an integer value that is adjusted relative to the map size. Default is "0"! Example: -2, 3, 5.
<value> can be a percentage value from 1% to 100%. Default is "100%"!
If a percentage value is passed, the % character must be url-encoded: Example for "90%" =>"90%25".
Bsp.:
https://maps1.locr.com/batch-processing/job_v2.php?request_id=<RequestId>&action=configure&shop_icon_name=flag1&shop_icon_color=BL&shop_icon_type=type2
Sample request for a configuration
<?xml version="1.0" encoding="utf-8"?>
<BatchProcessing>
<Response>
<MetaInfo>
<RequestId>4fec2eb23a16880b77000000</RequestId>
<Name>jobname</Name>
<Created>2012-06-01 12:00:00</Created>
</MetaInfo>
<Configuration>
<Geocoder>
<tolerance>normal</tolerance>
<min_accuracy/>
<postal_accuracy/>
</Geocoder>
<Router>
<type>F</type>
<color>BK</color>
<width>5</width>
</Router>
<Maps>
<config>1</config>
<size_width>14.8</size_width>
<size_height>10.5</size_height>
<size_unit>cm</size_unit>
<icons>
<customer>
<I>pin1</I>
<C>BL</C>
</customer>
<shop>
<I>button1</I>
<C>AQ</C>
</shop>
</icons>
<border>
<top>0.125</top>
<right>0.125</right>
<bottom>0.125</bottom>
<left>0.125</left>
</border>
</Maps>
</Configuration>
</Response>
</BatchProcessing>
|
