Maintained
2.0 (upcoming) 1.2 (current)
Unmaintained
1.1 1.0
Edit

Geospatial Queries

You can execute some special queries when using geospatial indexes like checking for documents within a rectangle or circle.

Mapping

First, setup some documents like the following:

  • PHP
    <?php

/**
 * @Document
 * @Index(keys={"coordinates"="2d"})
 */
class City
{
    /** @Id */
    public $id;

    /** @Field(type="string") */
    public $name;

    /** @EmbedOne(targetDocument="Coordinates") */
    public $coordinates;
}

/** @EmbeddedDocument */
class Coordinates
{
    /** @Field(type="float") */
    public $x;

    /** @Field(type="float") */
    public $y;
}
  • XML
    <indexes>
    <index>
        <key name="coordinates" order="2d" />
    </index>
</indexes>

Near Query

Now you can execute queries against these documents like the following. Check for the 10 nearest cities to a given longitude and latitude with the near($longitude, $latitude) method:

<?php

$cities = $this->dm->createQuery('City')
    ->field('coordinates')->near(-120, 40)
    ->execute();