Forgot password?
Unexpected error occurred

API Reference

This functions supports paging and a field filters.

Parameters:

APIKEY - Your API key
COUNTRYCODE - Two letter ISO country code
REGION - Region or state abbreviation
CITY - City name
POSTALCODE - Postal or zip code
DISTANCE - Distance in miles
PLACETYPE - Type of place ("City", "PostalCode") or a category of the user-defined place ("Apple Store", "Branch", etc)
{COORDINATES} - GPS coordinates in {LAT}_{LON} format, only REST interface supports coordinates

Examples:

Request:
http://api.geosvc.com/rest/{COUNTRYCODE}/{REGION}/{CITY}/nearby?apikey={APIKEY}&d={DISTANCE}&pt={PLACETYPE}
http://api.geosvc.com/rest/{COUNTRYCODE}/{POSTALCODE}/nearby?apikey={APIKEY}&d={DISTANCE}&pt={PLACETYPE}
http://api.geosvc.com/rest/point/{COORDINATES}/nearby?apikey={APIKEY}&d={DISTANCE}&pt={PLACETYPE}
Response:
[
    {
        "Type": "City",
        "City": "Hollywood",
        "Region": "CA",
        "Lat": 34.099218,
        "Lon": -118.33539,
        "Distance":       {
            "Value": 0,
            "Unit": "Miles"
        }
    }
]
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:geos="http://geoservice/">
    <soapenv:Header>
        <geos:ApiKey>{APIKEY}</geos:ApiKey>
    </soapenv:Header>
    <soapenv:Body>
        <geos:Nearby>
            <geos:Country&{gtCOUNTRYCODE}</geos:Country>
            <geos:Distance>{DISTANCE}</geos:Distance>
            <geos:Place>[{CITY},{REGION}]|{POSTALCODE}</geos:Place>
            <geos:PlaceType>{PLACETYPE}</geos:PlaceType>
        </geos:Nearby>
    </soapenv:Body>
</soapenv:Envelope>
Response:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <Locations xmlns="http://geoservice/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Location>
            <Type>City</Type>
            <City>Los Angeles</City>
            <Region>CA</Region>
            <Lat>34.091104</Lat>
            <Lon>-118.38202</Lon>
            <Distance>
                <Value>0</Value>
                <Unit>Miles</Unit>
            </Distance>
            </Location>
        </Locations>
    </s:Body>
</s:Envelope>
Request:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://skats.net/services/">
   <soapenv:Header>
      <AuthenticationHeader xsi:type="ser:AuthenticationHeader">
         <SessionID xsi:type="xsd:string">{APIKEY}</SessionID>
      </AuthenticationHeader>
   </soapenv:Header>
   <soapenv:Body>
      <ser:GetPlacesWithin soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <place xsi:type="xsd:string">{CITY}|{POSTALCODE}</place>
         <state xsi:type="xsd:string">{REGION}</state>
         <distance xsi:type="xsd:float">{DISTANCE}</distance>
         <placeTypeToFind xsi:type="ser:GeoPlaceType">{PLACETYPE}</placeTypeToFind>
      </ser:GetPlacesWithin>
   </soapenv:Body>
</soapenv:Envelope>
Response:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="http://skats.net/services/" xmlns:types="http://skats.net/services/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
      <types:GetPlacesWithinResponse>
         <GetPlacesWithinResult href="#id1"/>
      </types:GetPlacesWithinResponse>
      <soapenc:Array id="id1" soapenc:arrayType="types:GeoPlaceDistance[2]">
         <Item href="#id2"/>
         <Item href="#id3"/>
      </soapenc:Array>
      <types:GeoPlaceDistance id="id2" xsi:type="types:GeoPlaceDistance">
         <ToPlace xsi:type="xsd:string">North York</ToPlace>
         <ToState xsi:type="xsd:string">ON</ToState>
         <Distance xsi:type="xsd:float">0</Distance>
      </types:GeoPlaceDistance>
      <types:GeoPlaceDistance id="id3" xsi:type="types:GeoPlaceDistance">
         <ToPlace xsi:type="xsd:string">Toronto</ToPlace>
         <ToState xsi:type="xsd:string">ON</ToState>
         <Distance xsi:type="xsd:float">0</Distance>
      </types:GeoPlaceDistance>
   </soap:Body>
</soap:Envelope>
The legacy web service has a separate function for User Defined Places (UDPs).
Request:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://skats.net/services/">
   <soapenv:Header>
      <AuthenticationHeader xsi:type="ser:AuthenticationHeader">
         <SessionID xsi:type="xsd:string">{APIKEY}</SessionID>
      </AuthenticationHeader>
   </soapenv:Header>
   <soapenv:Body>
      <ser:GetUserPlacesWithin soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <place xsi:type="xsd:string">{CITY}|{POSTALCODE}</place>
         <state xsi:type="xsd:string">{REGION}</state>
         <distance xsi:type="xsd:float">{DISTANCE}</distance>
         <category xsi:type="ser:GeoPlaceType">{PLACETYPE}</category>
      </ser:GetUserPlacesWithin>
   </soapenv:Body>
</soapenv:Envelope>
Response:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="http://skats.net/services/" xmlns:types="http://skats.net/services/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
      <types:GetUserPlacesWithinResponse>
         <GetUserPlacesWithinResult href="#id1"/>
      </types:GetUserPlacesWithinResponse>
      <soapenc:Array id="id1" soapenc:arrayType="types:GeoPlaceDistance[2]">
         <Item href="#id2"/>
         <Item href="#id3"/>
      </soapenc:Array>
      <types:GeoPlaceDistance id="id2" xsi:type="types:GeoPlaceDistance">
         <ToPlace xsi:type="xsd:string">North York</ToPlace>
         <ToState xsi:type="xsd:string">ON</ToState>
         <Distance xsi:type="xsd:float">0</Distance>
      </types:GeoPlaceDistance>
      <types:GeoPlaceDistance id="id3" xsi:type="types:GeoPlaceDistance">
         <ToPlace xsi:type="xsd:string">Toronto</ToPlace>
         <ToState xsi:type="xsd:string">ON</ToState>
         <Distance xsi:type="xsd:float">0</Distance>
      </types:GeoPlaceDistance>
   </soap:Body>
</soap:Envelope>

Parameters:

APIKEY - Your API key
COUNTRYCODE - Two letter ISO country code
REGION - Region or state abbreviation
CITY - City name
POSTALCODE - Postal or zip code
PLACETYPE - Type of place ("City", "PostalCode")

Examples:

Request:
http://api.geosvc.com/rest/{COUNTRYCODE}/{REGION}/{CITY}/contains?apikey={APIKEY}&pt={PLACETYPE}
http://api.geosvc.com/rest/{COUNTRYCODE}/{POSTALCODE}/contains?apikey={APIKEY}&pt={PLACETYPE}
Response:
[
    {
        "Type": "City",
        "City": "Hollywood",
        "Region": "CA",
        "Lat": 34.099218,
        "Lon": -118.33539,
        "Distance":       {
            "Value": 0,
            "Unit": "Miles"
        }
    }
]
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:geos="http://geoservice/">
    <soapenv:Header>
        <geos:ApiKey>{APIKEY}</geos:ApiKey>
    </soapenv:Header>
    <soapenv:Body>
        <geos:Contains>
            <geos:Country&{gtCOUNTRYCODE}</geos:Country>
            <geos:Place>[{CITY},{REGION}]|{POSTALCODE}</geos:Place>
            <geos:PlaceType>{PLACETYPE}</geos:PlaceType>
        </geos:Contains>
    </soapenv:Body>
</soapenv:Envelope>
Response:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <Locations xmlns="http://geoservice/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Location>
            <Type>City</Type>
            <City>Los Angeles</City>
            <Region>CA</Region>
            <Lat>34.091104</Lat>
            <Lon>-118.38202</Lon>
            <Distance>
                <Value>0</Value>
                <Unit>Miles</Unit>
            </Distance>
            </Location>
        </Locations>
    </s:Body>
</s:Envelope>
Request:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://skats.net/services/">
   <soapenv:Header>
      <AuthenticationHeader xsi:type="ser:AuthenticationHeader">
         <SessionID xsi:type="xsd:string">${APIKEY}</SessionID>
      </AuthenticationHeader>
   </soapenv:Header>
   <soapenv:Body>
      <ser:GetPlacesInside soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <place xsi:type="xsd:string">{CITY}|{POSTALCODE}</place>
         <state xsi:type="xsd:string">{REGION}</state>
      </ser:GetPlacesInside>
   </soapenv:Body>
</soapenv:Envelope>
Response:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="http://skats.net/services/" xmlns:types="http://skats.net/services/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
      <types:GetPlacesInsideResponse>
         <GetPlacesInsideResult href="#id1"/>
      </types:GetPlacesInsideResponse>
      <soapenc:Array id="id1" soapenc:arrayType="types:GeoPlaceDistance[2]">
         <Item href="#id2"/>
         <Item href="#id3"/>
      </soapenc:Array>
      <types:GeoPlaceDistance id="id2" xsi:type="types:GeoPlaceDistance">
         <ToPlace xsi:type="xsd:string">Hollywood</ToPlace>
         <ToState xsi:type="xsd:string">CA</ToState>
         <Distance xsi:type="xsd:float">0.534881949</Distance>
      </types:GeoPlaceDistance>
      <types:GeoPlaceDistance id="id3" xsi:type="types:GeoPlaceDistance">
         <ToPlace xsi:type="xsd:string">Los Angeles</ToPlace>
         <ToState xsi:type="xsd:string">CA</ToState>
         <Distance xsi:type="xsd:float">4.59681034</Distance>
      </types:GeoPlaceDistance>
   </soap:Body>
</soap:Envelope>

Parameters:

APIKEY - Your API key
COUNTRYCODE - Two letter ISO country code
REGION - Region or state abbreviation
CITY - City name
POSTALCODE - Postal or zip code
COUNTRYCODE2 - Two letter ISO country code
REGION2 - Region or state abbreviation
CITY2 - City name
POSTALCODE2 - Postal or zip code

Examples:

Request:
http://api.geosvc.com/rest/{COUNTRYCODE}/{REGION}/{CITY}/distance?apikey={APIKEY}&p={CITY2}|{POSTALCODE2}&r={REGION2}&c={COUNTRYCODE2}
http://api.geosvc.com/rest/{COUNTRYCODE}/{POSTALCODE}/distance?apikey={APIKEY}&p={CITY2}|{POSTALCODE2}&r={REGION2}&c={COUNTRYCODE2}
Response:
{
   "Value": 13.97681283667274,
   "Unit": "Miles"
}
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:geos="http://geoservice/">
   <soapenv:Header>
      <geos:ApiKey>{APIKEY}</geos:ApiKey>
   </soapenv:Header>
   <soapenv:Body>
      <geos:GetDistance>
         <geos:Country>{COUNTRYCODE}</geos:Country>
         <geos:CountryTo>{COUNTRYCODE2}</geos:CountryTo>
         <geos:Place>[{CITY},{REGION}]|{POSTALCODE}</geos:Place>
         <geos:PlaceTo>[{CITY2},{REGION2}]|{POSTALCODE2}</geos:PlaceTo>
      </geos:GetDistance>
   </soapenv:Body>
</soapenv:Envelope>
Response:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <Distance xmlns="http://geoservice/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
         <Value>11.186699778747128</Value>
         <Unit>Miles</Unit>
      </Distance>
   </s:Body>
</s:Envelope>
Request:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://skats.net/services/">
   <soapenv:Header>
      <AuthenticationHeader xsi:type="ser:AuthenticationHeader">
         <SessionID xsi:type="xsd:string">{APIKEY}</SessionID>
      </AuthenticationHeader>
   </soapenv:Header>
   <soapenv:Body>
      <ser:GetDistanceBetweenPlaces soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <place1 xsi:type="xsd:string">{CITY}|{POSTALCODE}</place1>
         <state1 xsi:type="xsd:string">{REGION}</state1>
         <place2 xsi:type="xsd:string">{CITY2}|{POSTALCODE2}</place2>
         <state2 xsi:type="xsd:string">{REGION2}</state2>
      </ser:GetDistanceBetweenPlaces>
   </soapenv:Body>
</soapenv:Envelope>
Response:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="http://skats.net/services/" xmlns:types="http://skats.net/services/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
      <types:GetDistanceBetweenPlacesResponse>
         <GetDistanceBetweenPlacesResult xsi:type="xsd:float">11.4666691</GetDistanceBetweenPlacesResult>
      </types:GetDistanceBetweenPlacesResponse>
   </soap:Body>
</soap:Envelope>

Parameters:

APIKEY - Your API key
COUNTRYCODE - Two letter ISO country code
REGION - Region or state abbreviation
CITY - City name
POSTALCODE - Postal or zip code

Examples:

Request:
http://api.geosvc.com/rest/{COUNTRYCODE}/{REGION}/{CITY}?apikey={APIKEY}
http://api.geosvc.com/rest/{COUNTRYCODE}/{POSTALCODE}?apikey={APIKEY}
Response:
{
   "Type": "City",
   "Name": "Hollywood",
   "City": "Hollywood",
   "Region": "CA",
   "Lat": 34.12356,
   "Lon": -118.28784
}
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:geos="http://geoservice/">
   <soapenv:Header>
      <geos:ApiKey>{APIKEY}</geos:ApiKey>
   </soapenv:Header>
   <soapenv:Body>
      <geos:GetPlace>
         <geos:Country>{COUNTRY}</geos:Country>
         <geos:Place>[{CITY},{REGION}]|{POSTALCODE}</geos:Place>
      </geos:GetPlace>
   </soapenv:Body>
</soapenv:Envelope>
Response:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <Location xmlns="http://geoservice/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
         <Type>City</Type>
         <Name>Hollywood</Name>
         <City>Hollywood</City>
         <Region>CA</Region>
         <Lat>34.12356</Lat>
         <Lon>-118.28784</Lon>
      </Location>
   </s:Body>
</s:Envelope>
Request:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://skats.net/services/">
   <soapenv:Header>
      <AuthenticationHeader xsi:type="ser:AuthenticationHeader">
         <SessionID xsi:type="xsd:string">{APIKEY}</SessionID>
      </AuthenticationHeader>
   </soapenv:Header>
   <soapenv:Body>
      <ser:GetPlaceDetails soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <place xsi:type="xsd:string">{CITY}</place>
         <state xsi:type="xsd:string">{REGION}</state>
      </ser:GetPlaceDetails>
   </soapenv:Body>
</soapenv:Envelope>
Response:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="http://skats.net/services/" xmlns:types="http://skats.net/services/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
      <types:GetPlaceDetailsResponse>
         <GetPlaceDetailsResult href="#id1"/>
      </types:GetPlaceDetailsResponse>
      <types:GeoPlaceDetails id="id1" xsi:type="types:GeoPlaceDetails">
         <Name xsi:type="xsd:string">Hollywood</Name>
         <Type xsi:type="types:GeoPlaceType">City</Type>
         <State xsi:type="xsd:string">CA</State>
         <LatDegrees xsi:type="xsd:float">34.10733</LatDegrees>
         <LonDegrees xsi:type="xsd:float">-118.315437</LonDegrees>
         <LatRadians xsi:type="xsd:float">0.595285237</LatRadians>
         <LonRadians xsi:type="xsd:float">-2.06499386</LonRadians>
      </types:GeoPlaceDetails>
   </soap:Body>
</soap:Envelope>

Parameters:

APIKEY - Your API key

Examples:

Request:
http://api.geosvc.com/rest/udp?apikey={APIKEY}
Response:
[
      {
      "Id": "2562098",
      "Type": "UserDefined",
      "Name": "Office Depot",
      "Address": "401 E 2ND STREET",
      "City": "Los Angeles",
      "Region": "CA",
      "PostalCode": "90012",
      "Country": "US",
      "Lat": 34.0482281,
      "Lon": -118.2386559,
      "Category": "OfficeDepot",
      "UserData": ""
   }
]
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:geos="http://geoservice/">
   <soapenv:Header>
      <geos:ApiKey>{APIKEY}</geos:ApiKey>
   </soapenv:Header>
   <soapenv:Body>
      <geos:GetUserPlaces/>
   </soapenv:Body>
</soapenv:Envelope>
Response:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <Locations xmlns="http://geoservice/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
         <Location>
            <Id>2562098</Id>
            <Type>UserDefined</Type>
            <Name>Office Depot</Name>
            <Address>401 E 2ND STREET</Address>
            <City>Los Angeles</City>
            <Region>CA</Region>
            <PostalCode>90012</PostalCode>
            <Country>US</Country>
            <Lat>34.0482281</Lat>
            <Lon>-118.2386559</Lon>
            <Category>OfficeDepot</Category>
            <UserData/>
         </Location>
      </Locations>
    </s:Body>
</s:Envelope>
Request:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://skats.net/services/">
   <soapenv:Header>
      <AuthenticationHeader xsi:type="ser:AuthenticationHeader">
         <SessionID xsi:type="xsd:string">${#Project#ApiKey}</SessionID>
      </AuthenticationHeader>
   </soapenv:Header>
   <soapenv:Body>
      <ser:GetAllUserPlaces soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
   </soapenv:Body>
</soapenv:Envelope>
Response:
soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="http://skats.net/services/" xmlns:types="http://skats.net/services/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
      <types:GetAllUserPlacesResponse>
         <GetAllUserPlacesResult href="#id1"/>
      </types:GetAllUserPlacesResponse>
      <soapenc:Array id="id1" soapenc:arrayType="types:UserPlaceDetail[281]">
         <Item href="#id2"/>
      </soapenc:Array>
      <types:UserPlaceDetail id="id2" xsi:type="types:UserPlaceDetail">
         <Id xsi:type="xsd:int">2558211</Id>
         <Name xsi:type="xsd:string">Office Depot</Name>
         <Address xsi:type="xsd:string">401 E 2ND STREET</Address>
         <City xsi:type="xsd:string">LOS ANGELES</City>
         <State xsi:type="xsd:string">CA</State>
         <ZipCode xsi:type="xsd:string">90012</ZipCode>
         <Category xsi:type="xsd:string">OfficeDepot</Category>
         <Data xsi:type="xsd:string"/>
         <LatDegrees xsi:type="xsd:float">34.06368</LatDegrees>
         <LonDegrees xsi:type="xsd:float">-118.2389</LonDegrees>
         <LatRadians xsi:type="xsd:float">0.5945234</LatRadians>
         <LonRadians xsi:type="xsd:float">-2.063658</LonRadians>
         <Distance xsi:type="xsd:float">0</Distance>
         <Country xsi:type="xsd:string">US</Country>
      </types:UserPlaceDetail>
   </soap:Body>
</soap:Envelope>

Parameters:

APIKEY - Your API key
ID - Unique ID of the user-defined place

Examples:

Request:
http://api.geosvc.com/rest/udp/{ID}?apikey={APIKEY}
Response:
{
    "Id": "2562098",
    "Type": "UserDefined",
    "Name": "Office Depot",
    "Address": "401 E 2ND STREET",
    "City": "Los Angeles",
    "Region": "CA",
    "PostalCode": "90012",
    "Country": "US",
    "Lat": 34.0482281,
    "Lon": -118.2386559,
    "Category": "OfficeDepot",
    "UserData": ""
}
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:geos="http://geoservice/">
   <soapenv:Header>
      <geos:ApiKey>{APIKEY}</geos:ApiKey>
   </soapenv:Header>
   <soapenv:Body>
      <geos:GetUserPlace>
         <geos:Id>{ID}</geos:Id>
      </geos:GetUserPlace>
   </soapenv:Body>
</soapenv:Envelope>
Response:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <Location xmlns="http://geoservice/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
         <Id>2562098</Id>
         <Type>UserDefined</Type>
         <Name>Office Depot</Name>
         <Address>401 E 2ND STREET</Address>
         <City>Los Angeles</City>
         <Region>CA</Region>
         <PostalCode>90012</PostalCode>
         <Country>US</Country>
         <Lat>34.0482281</Lat>
         <Lon>-118.2386559</Lon>
         <Category>OfficeDepot</Category>
         <UserData/>
      </Location>
   </s:Body>
</s:Envelope>
Not supported
Inserts new UDP if Id field is empty or missing. Updates an existing UDP if Id field is passed in.

Parameters:

APIKEY - Your API key

Examples:

Request:
POST http://api.geosvc.com/rest/udp?apikey={APIKEY}
Content-Type: application/json

{
   "Id": "2563157", // Optional, remove to insert new record
   "Type": "UserDefined",
   "Name": "Office Depot",
   "Address": "1200 W VALLEY BLVD",
   "City": "ALHAMBRA",
   "Region": "CA",
   "PostalCode": "91803",
   "Country": "US",
   "Category": "OfficeDepot",
   "UserData": "test"
}
                        
Response:
{
   "Id": "2563157",
   "Type": "UserDefined",
   "Name": "Office Depot",
   "Address": "1200 W VALLEY BLVD",
   "City": "ALHAMBRA",
   "Region": "CA",
   "PostalCode": "91803",
   "Country": "US",
   "Category": "OfficeDepot",
   "UserData": "test"
}
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:geos="http://geoservice/">
   <soapenv:Header>
      <geos:ApiKey>{APIKEY}</geos:ApiKey>
   </soapenv:Header>
   <soapenv:Body>
      <SaveUserPlace xmlns="http://geoservice/">
         <Id></Id>
         <Type>UserDefined</Type>
         <Name>Office Depot</Name>
         <Address>1200 W VALLEY BLVD</Address>
         <City>ALHAMBRA</City>
         <Region>CA</Region>
         <PostalCode>91803</PostalCode>
         <Country>US</Country>
         <Category>OfficeDepot</Category>
         <UserData>test</UserData>
      </SaveUserPlace>
   </soapenv:Body>
</soapenv:Envelope>
Response:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <Location xmlns="http://geoservice/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
         <Id>2563155</Id>
         <Type>UserDefined</Type>
         <Name>Office Depot</Name>
         <Address>1200 W VALLEY BLVD</Address>
         <City>ALHAMBRA</City>
         <Region>CA</Region>
         <PostalCode>91803</PostalCode>
         <Country>US</Country>
         <Category>OfficeDepot</Category>
         <UserData>test</UserData>
      </Location>
   </s:Body>
</s:Envelope>
Warning: legacy implementation overwrites all UDPs. It deletes existing places first and then saves new places.
Request:
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" 
xmlns:tns="http://skats.net/services/" 
xmlns:types="http://skats.net/services/" 
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <tns:AuthenticationHeader>
      <SessionID xsi:type="xsd:string">{APIKEY}</SessionID>
    </tns:AuthenticationHeader>
  </soap:Header>
  <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
    <tns:SaveUserPlaces>
      <places href="#id1" />
    </tns:SaveUserPlaces>
    <soapenc:Array id="id1" soapenc:arrayType="types:UserPlaceDetail[254]">
         <Item href="#id2"/>
    </soapenc:Array>
      <types:UserPlaceDetail id="id2" xsi:type="types:UserPlaceDetail">
         <Id xsi:type="xsd:int">2554575</Id>
         <Name xsi:type="xsd:string">4th Street</Name>
         <Address xsi:type="xsd:string">1823 4th Street</Address>
         <City xsi:type="xsd:string">Berkeley</City>
         <State xsi:type="xsd:string">CA</State>
         <ZipCode xsi:type="xsd:string">94710</ZipCode>
         <Category xsi:type="xsd:string">Apple Store</Category>
         <LatDegrees xsi:type="xsd:float">37.86997</LatDegrees>
         <LonDegrees xsi:type="xsd:float">-122.29631</LonDegrees>
         <LatRadians xsi:type="xsd:float">0.660955667</LatRadians>
         <LonRadians xsi:type="xsd:float">-2.13447332</LonRadians>
         <Distance xsi:type="xsd:float">0</Distance>
         <Country xsi:type="xsd:string">US</Country>
      </types:UserPlaceDetail>
  </soap:Body>
</soap:Envelope>
Response:
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="http://skats.net/services/" xmlns:types="http://skats.net/services/encodedTypes" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
    <tns:SaveUserPlacesResponse />
  </soap:Body>
</soap:Envelope>

Parameters:

APIKEY - Your API key
ID - Unique ID of the user-defined place

Examples:

Request:
DELETE http://api.geosvc.com/rest/udp/{ID}?apikey={APIKEY}
Response:
HTTP 200
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:geos="http://geoservice/">
   <soapenv:Header>
      <geos:ApiKey>{APIKEY}</geos:ApiKey>
   </soapenv:Header>
   <soapenv:Body>
      <DeleteUserPlace xmlns="http://geoservice/">
         <Id>{ID}</Id>
      </DeleteUserPlace>
   </soapenv:Body>
</soapenv:Envelope>
Response:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
   </s:Body>
</s:Envelope>
Not supported