Denne service gør det muligt at hente en liste med steder, der alle opfylder et eller flere kriterier. Man kan søge „fritekst“, eller på nøgleord eller efter steder i nærheden af en GPS position.

Fra version 1.0
Fritekstsøgning giver mulighed for at søge efter steder, der indeholder bestemte ord i deres navn, adresse, nøgleord eller anmeldelser.

URL'en for at foretage en fritekstsøgning er:

http://api.mitkbh.dk/[api version]/nodes/?search=[query]

Fra version 1.0
Nøgleordssøgning giver mulighed for at søge efter steder, der er blevet tilknyttet specifikkke nøgleord i tekst-form ¹⁾.

URL'en for at foretage en nøgleordssøgning er:

http://api.mitkbh.dk/[api version]/nodes/?tags=[tags]

Fra version 1.0
Geografisk søgning giver mulighed for at søge efter steder, der ligger i nærheden af et punkt defineret ved en længdegrad og en breddegrad. Der bliver på nuværende tidspunkt leveret steder, der ligger inden for en radius af ca. 800 m. fra punktet.

Hvis du har brug for at få en længdegrad og en breddegrad ud fra en adresse kan du bruge Googles geocoding API.

URL'en for at foretage en geografisk søgning er:

http://api.mitkbh.dk/[api version]/nodes/?lat=[latitude]&lon=[longitude]

Fra version 1.1
Geografisk „boks“ søgning giver mulighed for at søge efter steder, der ligger inden for en defineret kasse - eller boundary.
Der skal angives to punkter, hvorefter en rektangel bliver beregnet i API'en.
Du skal altså angive minlat,maxlon og maxlat,minlon

 minlat,maxlon
 X-----------------
 |                |
 |                |
 |                |
 |                |
 |                |
 |                |
 -----------------X
                  maxlat,minlon

Dette kan fx bruges til Google Maps - eller deres nye Mapplets.
Der returneres samme data som i Geografisk søgning (radius) dog med den forskel, at distance er afstanden til centrum af boksen.

URL'en for at foretage en geografisk boks søgning er:

http://api.mitkbh.dk/[api version]/nodes/?minlat=[latitude]&maxlon=[longitude]&maxlat=[latitude]&minlon=[longitude]

Sted søgning kan modificeres ved hjælp af en række frivillige parametre, der giver muliged for at sortere i og begrænse søgeresultaterne, der virker for både fritekst søgning, tag søgning og geografisk søgning.

Her kommer en lidt uddybende forklaring på orderby parameteren.

Kategorierne du kan søge inden for igennem nodetype parameteren er:

Lad være med at spørge hvad der blev af 8 og 9 :).

Klik på eksempel-linksne for at se hvad de returnerer.

Eksempel på resultat for http://api.mitkbh.dk/1.x/nodes/?search=Atame

<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
  <nodesearchresult>
    <resultsreturned>2</resultsreturned>
    <resultsfound>2</resultsfound>
    <nodes>
      <node>
        <id>43</id>
        <name>Atame</name>
        <address>
          <street>Blågårdsgade 3</street>
        </address>
        <position>
          <latitude>55.687746159518824</latitude>
          <longitude>12.559905052185059</longitude>
        </position>
        <nodetypes>
          <nodetype id="7" primary="true">Spisesteder</nodetype>
        </nodetypes>
        <rating>
          <score>4.4211</score>
          <votes>19</votes>
        </rating>
        <teaser>...&lt;b&gt;Atame&lt;/b&gt; er et super sted. Maden
        er hjemmelavet, god og billig. Øllet flyder og maden kommer
        i en lind</teaser>
      </node>
      <!-- flere resultater -->
    </nodes>
  </nodesearchresult>
</response>

Ved søgning på geografisk placering resulterer i lidt ekstra information med for hver node i XML resultatet:

<distance>
  <kilometer>0.0835</kilometer>
  <textual>84m</textual>
</distance>

Distance skal dog tages med et gran salt. Det er i luft linie og ikke vildt præcist, men en god indikator på afstanden mellem to punkter.

Her vises rating→score og rating→votes ved en normal søgning.

<rating>
  <score>5.2353</score>
  <votes>17</votes>
</rating>

Når et søgeresultat skal sorteres efter vægtet vurdering tilføjes rating→weighted:

<rating>
  <score>5.2353</score>
  <votes>17</votes>
  <weighted>4.9228636363636</weighted>
</rating>

Den kommer kun med når vægtet rating, fordi den er ret tung at beregne.