Service de transformation de coordonnées

Cette page n’est plus maintenue depuis la version 2022 de Geoconcept Web. Pour accéder à la documentation à jour de ce web service, veuillez suivre ce lien.

Principe

Ce web service permet de transformer des couples de coordonnées d’une projection à une autre. Par exemple, de Lambert 2 étendue vers WGS 84.

Disponibilité

Ce web service est disponible en permanence avec Geoconcept Web.

V1

Paramètres / propriétés

En entrée

paramètre	description	optionnel
inSrs	projection en entrée (code EPSG comme epsg:4326 ou wgs84)	non
outSrs	projection en sortie (code EPSG comme epsg:4326 ou wgs84)	non
point (ou points en JSON / JSON-P)	Coordonnées des points en SOAP, il est nécessaire de remplir les coordonnées dans chacune des balises dédiées <x></x> et <y></y> en REST, Les points sont séparés par le caractère « , ». Les points sont caractèrisés par un couple de coordonnées XY séparés par une « ; ».	non

En sortie

Points transformés (srsTransformResult)

paramètre	type	min/max	description
point (ou points en JSON / JSON-P)	geographicPoint (ou array en JSON / JSON-P)	0/illimité	points tranformés

Points(geographicPoint)

paramètre	type	min/max	description
x	double	1/1	première coordonnée ou longitude
y	double	1/1	deuxième coordonnée ou latitude

SOAP

WSDL

http://<server>/<webapp>/api/ws/srsTransformService?wsdl

Requête

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="http://geoconcept.com/gc/schemas">
   <soapenv:Header/>
   <soapenv:Body>
      <sch:srsTransform>
         <!--Optional:-->
         <request>
            <!--Optional:-->
            <inSrs>epsg:27572</inSrs>
            <!--Optional:-->
            <outSrs>epsg:4326</outSrs>
            <!--Zero or more repetitions:-->
            <point>
               <x>246087</x>
               <y>2262265</y>
            </point>
             <point>
               <x>255081</x>
               <y>2262679</y>
            </point>
            <point>
               <x>298976</x>
               <y>2254643</y>
            </point>
         </request>
      </sch:srsTransform>
   </soapenv:Body>
</soapenv:Envelope>

Réponse

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:srsTransformResponse xmlns:ns2="http://geoconcept.com/gc/schemas">
         <srsTransformResult>
            <status>OK</status>
            <point>
               <x>-2.343140132718342</x>
               <y>47.26525078744117</y>
            </point>
            <point>
               <x>-2.2248034057039128</x>
               <y>47.27372258177934</y>
            </point>
            <point>
               <x>-1.6400114587002539</x>
               <y>47.22297983102492</y>
            </point>
         </srsTransformResult>
      </ns2:srsTransformResponse>
   </soap:Body>
</soap:Envelope>

REST (POST)

Requête

Requête

http://<server>/<webapp>/api/lbs/srsTransform.xml

Data (XML)

<?xml version="1.0" encoding="UTF-8"?>
<srsTransformRequest>
  <inSrs>epsg:27572</inSrs>
  <outSrs>epsg:4326</outSrs>
  <point>
    <x>246087</x>
    <y>2262265</y>
  </point>
  <point>
    <x>255081</x>
    <y>2262679</y>
   </point>
   <point>
    <x>298976</x>
    <y>2254643</y>
    </point>
</srsTransformRequest>

Réponse

La réponse est toujours encodée en UTF-8.

Format XML

<srsTransformResult>
   <status>OK</status>
   <point>
      <x>-2.343140132718342</x>
      <y>47.26525078744117</y>
   </point>
   <point>
      <x>-2.2248034057039128</x>
      <y>47.27372258177934</y>
   </point>
   <point>
      <x>-1.6400114587002539</x>
      <y>47.22297983102492</y>
   </point>
</srsTransformResult>

REST (GET)

Requête

Requête JSON

http://<server>/<webapp>/api/lbs/srsTransform.json?&inSrs=epsg:27572&outSrs=epsg:4326&points=246087,2262265;255081,2262679;298976,2254643

Requête JSON-P

http://<server>/<webapp>/api/lbs/srsTransform.json?&inSrs=epsg:27572&outSrs=epsg:4326&points=246087,2262265;255081,2262679;298976,2254643&callback=MyCallBack

Requête XML

http://<server>/<webapp>/api/lbs/srsTransform.xml?&inSrs=epsg:27572&outSrs=epsg:4326&points=246087,2262265;255081,2262679;298976,2254643

Réponse

La réponse est toujours encodée en UTF-8.

Format JSON

{
   "message": null,
   "status": "OK",
   "points":    [
            {
         "x": -2.343140132718342,
         "y": 47.26525078744117
      },
            {
         "x": -2.2248034057039128,
         "y": 47.27372258177934
      },
            {
         "x": -1.6400114587002539,
         "y": 47.22297983102492
      }
   ]
}

Format JSON-P

myCallback(
    {
       "message": null,
       "status": "OK",
       "points":    [
                {
             "x": -2.343140132718342,
             "y": 47.26525078744117
          },
                {
             "x": -2.2248034057039128,
             "y": 47.27372258177934
          },
                {
             "x": -1.6400114587002539,
             "y": 47.22297983102492
          }
       ]
    }
);

Format XML

<srsTransformResult>
   <status>OK</status>
   <point>
      <x>-2.343140132718342</x>
      <y>47.26525078744117</y>
   </point>
   <point>
      <x>-2.2248034057039128</x>
      <y>47.27372258177934</y>
   </point>
   <point>
      <x>-1.6400114587002539</x>
      <y>47.22297983102492</y>
   </point>
</srsTransformResult>

Retours possibles

Cas d’un itinéraire trouvé (srsTransformResult/status est OK)

<srsTransformResult>
    <status>OK</status>
    <point>
       <x>-2.343140132718342</x>
       <y>47.26525078744117</y>
    </point>
    <point>
       <x>-2.2248034057039128</x>
       <y>47.27372258177934</y>
    </point>
    <point>
       <x>-1.6400114587002539</x>
       <y>47.22297983102492</y>
    </point>
</srsTransformResult>

Cas de la projection de départ vide

<soap:Fault>
    <faultcode xmlns:ns1="geoconcept.com">ns1:8</faultcode>
    <faultstring>inSrs can't be null or empty</faultstring>
</soap:Fault>

Cas de la projection de destination vide

<soap:Fault>
    <faultcode xmlns:ns1="geoconcept.com">ns1:8</faultcode>
    <faultstring>outSrs can't be null or empty</faultstring>
</soap:Fault>

Cas d’une projection incorrecte

<soap:Fault>
    <faultcode xmlns:ns1="geoconcept.com">ns1:8</faultcode>
    <faultstring>inSrs or outSrs do not exist</faultstring>
</soap:Fault>

Cas de coordonnée d’un point vide

<soap:Fault>
    <faultcode xmlns:ns1="geoconcept.com">ns1:8</faultcode>
    <faultstring>Unmarshalling Error:</faultstring>
</soap:Fault>

Cas d’un mauvais typage sur les coordonnées des points

<soap:Fault>
    <faultcode xmlns:ns1="geoconcept.com">ns1:8</faultcode>
    <faultstring>Unmarshalling Error: 488degree
488degree
488degree
488degre</faultstring>
</soap:Fault>

Précédent	Niveau supérieur	Suivant
	Sommaire

Documentation des Web Services de Geoconcept Web - Web Services