• Table of contents
• Examples for URI requests to the Map REST Service
  • Map REST Service - Version 1
    • 1. Distribution Maps
      • 1.1.
      • 1.2.
      • 1.3.
      • 1.3.(b)
      • Using different background layers
      • 1.4.
      • 1.5.
  • Occurrence Maps
    • • 1.5.
      • 1.6.
    • Map REST Service - next Version

Examples for URI requests to the Map REST Service¶

Integrate clear colourful maps into your own website or application. Choose data sources and adapt colour, symbology, extent, background textures and line types to fully customise your map.

This page give some usage examples of the Map REST Service API.

Be aware that these examples *don't conform to RFC 398*6, as the current implementation still doesn't follow the proposed syntaxis. It means that the syntaxis of these examples (and MapRest Services) may change in the coming weeks.

Map REST Service - Version 1¶

_ Does not conform to the latest syntax definition! _

1. Distribution Maps¶

Service URL: http://edit.csic.es/v1/areas.php

---

1.1.¶

In this image...

Map Image size is specified as 400 pixels width. It means the height will be 200 pixels (just the half). Attention: you cannot specify an odd number as width/height.

A bounding box (bbox) is specified. We strongly recommend to use bbox if know it (for example if all your data is on the same zone).

We provide world country borders and all TDWG levels as background. This parameter must be specified in "l" parameter (l=earth in that example).

Current codes for background layers are:

-Country borders: earth

-TDWG level 1: tdwg1

-TDWG level 2: tdwg2

-TDWG level 3: tdwg3

-TDWG level 4: tdwg4

<code class="html">
<img src="http://edit.csic.es/v1/areas.php?l=earth&ad=tdwg3:a:PHI,VAN,BAN,SRL,VIE,MOL,CHC,CRL,JAW,FIJ,SUM,MYA,MLY,NWG,MRN,AND,CHH,BOR,IND,CHS,THA,TAI,LAO,SUL,BIS,CBD,SOL,ASS&as=a:8dd3c7,,1&ms=300&bbox=-180,-90,180,90" />

l=earth&ad=tdwg3:a:PHI,VAN,BAN,SRL,VIE,MOL,CHC,CRL,JAW,FIJ,SUM,MYA,MLY,NWG,MRN,AND,CHH,BOR,IND,CHS,THA,TAI,LAO,SUL,BIS,CBD,SOL,ASS
&as=a:8dd3c7,,1&ms=300&bbox=-180,-90,180,90

---

---

1.2.¶

We see here the "recalculate" parameter in action.

When the bbox is not specified, the service will calculate it and try to fit the image to the specified dimensions (width/height). It can cause distorted images.

Recalculate=true (this is the default if nothing is specified) tries to avoid these distortions. It means also that in some cases the final image size will change as you can see in the first image.

<code class="html">
<img src="http://edit.csic.es/v1/areas.php?l=earth&ad=tdwg3:a:PHI,VAN,BOR|b:BIS,SUM&as=a:8dd3c7,,2|b:e91f16,5be166,,2_4&ms=500&label=1" />

<code class="html">
<img src="http://edit.csic.es/v1/areas.php?l=earth&ad=tdwg3:a:PHI,VAN,BOR|b:BIS,SUM&as=a:8dd3c7,,2|b:e91f16,5be166,,2_4&ms=500&label=1&recalculate=false" />

l=earth&ad=tdwg3:a:PHI,VAN,BOR|b:BIS,SUM&as=a:8dd3c7,,2|b:e91f16,5be166,,2_4&ms=500&label=1

l=earth&ad=tdwg3:a:PHI,VAN,BOR|b:BIS,SUM&as=a:8dd3c7,,2|b:e91f16,5be166,,2_4&ms=500&label=1&recalculate=false

---

---

1.3.¶

You can mix different TDWG layers. In that case, TDWG level 3 and TDWG level 1.

No background layer is defined, so you simply get the specified areas.

<code class="html">
<img src="http://edit.csic.es/v1/areas.php?ad=tdwg3:b:ZIM|a:SPA,ITA||tdwg1:b:2&as=a:d7add2|b:ab8dc9F&ms=300,200&label=1" />

ad=tdwg3:b:ZIM|a:SPA,ITA||tdwg1:b:2&as=a:d7add2|b:ab8dc9F&ms=600,300&label=1

---

1.3.(b)¶

<code class="html">
<img src="http://edit.csic.es/v1/areas.php?l=earth&ad=tdwg3:a:NCS|b:YUG||tdwg4:a:TCSGR,NCSKB,NCSKC,TCSNK,LBSSY,TCSNA,TUROO,NCSDA,GRCOO&as=a:ff0000,,1|b:0000ff,,1&ms=600,300&bbox=-180,-90,180,90" />

l=earth&ad=tdwg3:a:NCS|b:YUG||tdwg4:a:TCSGR,NCSKB,NCSKC,TCSNK,LBSSY,TCSNA,TUROO,NCSDA,GRCOO&as=a:ff0000,,1|b:0000ff,,1&ms=600,300&bbox=-180,-90,180,90

---

---

Using different background layers¶

• ISO 3166 Code Countries *

Using earth in the l attribute.

1.4.¶

<code class="html">
<img src="http://edit.csic.es/v1/areas.php?l=earth&ad=tdwg1:b:1,2&as=b:ab8dc9F&ms=300,150&recalculate=true&label=1&bbox=-180,-90,180,90" />

l=earth&ad=tdwg1:b:1,2&as=b:ab8dc9F&ms=300,150&recalculate=true&label=1&bbox=-180,-90,180,90

• TDWG 2 Layer Countries *

Using tdwg2 in the l attribute.

1.5.¶

<code class="html">
<img src="http://edit.csic.es/v1/areas.php?l=tdwg2&ad=tdwg1:b:1,2&as=b:ab8dc9F&ms=300,150&recalculate=true&label=1&bbox=-180,-90,180,90" />

l=tdwg2&ad=tdwg1:b:1,2&as=b:ab8dc9F&ms=300,150&recalculate=true&label=1&bbox=-180,-90,180,90

---

Occurrence Maps¶

Service URL: http://edit.csic.es/v1/points.php

---

1.5.¶

<code class="html">
<img src="http://edit.csic.es/v1/points.php?l=v:e_provinces&od=1:41.842,43.30086%7C41.7093,43.50803%7C44.28416,7.39742%7C44.20383,7.43884&os=1:c/8B0000/10/Pieris%20rapae%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%7C2:s/64cb48/0/%20|3:s/64cb48/0/%20&ms=400,350&bbox=6.6,43.8,7.75,44.5&recalculate=true" />

l=v:e_provinces
&od=1:41.842,43.30086|41.7093,43.50803|44.28416,7.39742|44.20383,7.43884
&os=1:c/8B0000/10/Pieris%20rapae%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20|2:s/64cb48/0/%20|3:s/64cb48/0/%20
&ms=400,350&bbox=6.6,43.8,7.75,44.5&recalculate=true

---

1.6.¶

<code class="html">
<img src="http://edit.csic.es/v1/points.php?od=1:38.326,-0.822%7C38.328,-0.542%7C38.062,-0.893%7C%7C2:38.062,-0.893%7C38.012,-1.883%7C%7C3:40.78,-4.009%7C43.461,-5.412%7C38.062,-0.893&os=1:c/f78755/10/Onthophagus%20semipunctatus%7C2:s/64cb48/35/Euoniticellus%20pallipes%7C3:sq/cbde4f/20/Onthophagus%20joannae&ms=700x350&l=v:e_provinces&q_layer=e_provinces&recalculate=true" />

od=1:38.326,-0.822|38.328,-0.542|38.062,-0.893||2:38.062,-0.893|38.012,-1.883||3:40.78,-4.009|43.461,-5.412|38.062,-0.893
&os=1:c/f78755/10/Onthophagus%20semipunctatus|2:s/64cb48/35/Euoniticellus%20pallipes|3:sq/cbde4f/20/Onthophagus%20joannae
&ms=700x350&l=v:e_provinces&q_layer=e_provinces&recalculate=true

---

Map REST Service - next Version¶