URL:

http://twick.it/interfaces/api/find_topics_nearby.xml

http://twick.it/interfaces/api/find_topics_nearby.json

Function:

Retrieves all topics that are located nearby a position, which is specitied by a geo coordinate (latitude and longitude). The distance between the given position an the position of he topic is return at the tag called distance.

Parameters:

Output (XML):

http://twick.it/interfaces/api/find_topics_nearby.xml?latitude=50.875556&longitude=8.016667&radius=15000&limit=2

<?xml version="1.0" encoding="utf-8"?>
<result>
  <query>type=xml&latitude=50.875556&longitude=8.016667&radius=15000&limit=2</query>
  <topics>
    <topic>
      <distance>0</distance>
      <id>160</id>
      <title>Siegen</title>
      <url>http://twick.it/de/Siegen</url>
      <geo>
        <latitude>50.8756</latitude>
        <longitude>8.01667</longitude>
      </geo>
      <tags>
        <tag count="5">stadt</tag>
        <tag count="3">nrw</tag>
        <tag count="3">südwestfalen</tag>
        <tag count="3">kreis siegen wittgenstein</tag>
        <tag count="2">westfalen</tag>
        <tag count="2">einwohnern</tag>
        <tag count="2">siegerland</tag>
        <tag count="2">universitätsstadt</tag>
        <tag count="2">oberzentrum</tag>
        <tag count="1">besitzt</tag>
      </tags>
    </topic>
    <topic>
      <distance>209.31845068445</distance>
      <id>5935</id>
      <title>Apollo-Theater (Siegen)</title>
      <url>http://twick.it/de/Apollo-Theater-(Siegen)</url>
      <geo>
        <latitude>50.8739</latitude>
        <longitude>8.01806</longitude>
      </geo>
      <tags>
        <tag count="1">ensemble</tag>
        <tag count="1">ohne</tag>
        <tag count="1">führt</tag>
        <tag count="1">pro</tag>
        <tag count="1">bespieltheater</tag>
        <tag count="1">festes</tag>
        <tag count="1">spielzeit</tag>
        <tag count="1">intendant</tag>
        <tag count="1">drei</tag>
        <tag count="1">magnus</tag>
      </tags>
    </topic>
  </topics>
</result>

Output (JSON):

http://twick.it/interfaces/api/find_topics_nearby.json?latitude=50.875556&longitude=8.016667&radius=15000&limit=2

{
  "query" : "type=json&latitude=50.875556&longitude=8.016667&radius=15000&limit=2",
  "topics" : [
    {
      "distance" : 0,
      "id" : "160",
      "title" : "Siegen",
      "url" : "http://twick.it/de/Siegen",
      "geo" : {
        "latitude" : 50.8756,
        "longitude" : 8.01667
      },
      "tags" : [
        {
          "tag" : "stadt",
          "count" : "5"
        },
        {
          "tag" : "nrw",
          "count" : "3"
        },
        {
          "tag" : "südwestfalen",
          "count" : "3"
        },
        {
          "tag" : "kreis siegen wittgenstein",
          "count" : "3"
        },
        {
          "tag" : "westfalen",
          "count" : "2"
        },
        {
          "tag" : "einwohnern",
          "count" : "2"
        },
        {
          "tag" : "siegerland",
          "count" : "2"
        },
        {
          "tag" : "universitätsstadt",
          "count" : "2"
        },
        {
          "tag" : "oberzentrum",
          "count" : "2"
        },
        {
          "tag" : "besitzt",
          "count" : "1"
        }
      ]
    },
     {
      "distance" : 209.31845068445,
      "id" : "5935",
      "title" : "Apollo-Theater (Siegen)",
      "url" : "http://twick.it/de/Apollo-Theater-(Siegen)",
      "geo" : {
        "latitude" : 50.8739,
        "longitude" : 8.01806
      },
      "tags" : [
        {
          "tag" : "ensemble",
          "count" : "1"
        },
        {
          "tag" : "ohne",
          "count" : "1"
        },
        {
          "tag" : "führt",
          "count" : "1"
        },
        {
          "tag" : "pro",
          "count" : "1"
        },
        {
          "tag" : "bespieltheater",
          "count" : "1"
        },
        {
          "tag" : "festes",
          "count" : "1"
        },
        {
          "tag" : "spielzeit",
          "count" : "1"
        },
        {
          "tag" : "intendant",
          "count" : "1"
        },
        {
          "tag" : "drei",
          "count" : "1"
        },
        {
          "tag" : "magnus",
          "count" : "1"
        }
      ]
    }
  ]
}

<query>type=xml&amp;latitude=50.875556&amp;longitude=8.016667&amp;radius=15000&amp;limit=2</query>
<topics>
<topic>
<distance>0</distance>
<id>160</id>

<title>Siegen</title>
<url>http://twick.it/de/Siegen</url>
<geo>
<latitude>50.8756</latitude>
<longitude>8.01667</longitude>
</geo>
<tags>
<tag count="5">stadt</tag>
<tag count="3">nrw</tag>
<tag count="3">südwestfalen</tag>
<tag count="3">kreis siegen wittgenstein</tag>
<tag count="2">westfalen</tag>
<tag count="2">einwohnern</tag>
<tag count="2">siegerland</tag>
<tag count="2">universitätsstadt</tag>
<tag count="2">oberzentrum</tag>
<tag count="1">besitzt</tag>
</tags>
</topic>
<topic>
<distance>209.31845068445</distance>
<id>5935</id>
<title>Apollo-Theater (Siegen)</title>
<url>http://twick.it/de/Apollo-Theater-(Siegen)</url>
<geo>
<latitude>50.8739</latitude>
<longitude>8.01806</longitude>
</geo>
<tags>
<tag count="1">ensemble</tag>
<tag count="1">ohne</tag>
<tag count="1">führt</tag>
<tag count="1">pro</tag>
<tag count="1">bespieltheater</tag>
<tag count="1">festes</tag>
<tag count="1">spielzeit</tag>
<tag count="1">intendant</tag>
<tag count="1">drei</tag>
<tag count="1">magnus</tag>
</tags>
</topic>
</topics>