mirror of
https://github.com/spring-projects/spring-data-elasticsearch.git
synced 2025-06-01 09:42:11 +00:00
Created Geo Distance Search (markdown)
parent
b373cde2a1
commit
b852df7caf
87
Geo-Distance-Search.md
Normal file
87
Geo-Distance-Search.md
Normal file
@ -0,0 +1,87 @@
|
|||||||
|
### Geo indexing and request
|
||||||
|
|
||||||
|
You can make request using geo_distance filter. This can be done using GeoPoint object.
|
||||||
|
|
||||||
|
First, here is a sample of an entity with a GeoPoint field (location)
|
||||||
|
|
||||||
|
```java
|
||||||
|
@Document(indexName = "test-geo-index", type = "geo-class-point-type")
|
||||||
|
public class AuthorMarkerEntity {
|
||||||
|
|
||||||
|
@Id
|
||||||
|
private String id;
|
||||||
|
private String name;
|
||||||
|
|
||||||
|
private GeoPoint location;
|
||||||
|
|
||||||
|
private AuthorMarkerEntity(){
|
||||||
|
}
|
||||||
|
|
||||||
|
public AuthorMarkerEntity(String id){
|
||||||
|
this.id = id;
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getId() {
|
||||||
|
return id;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void setId(String id) {
|
||||||
|
this.id = id;
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getName() {
|
||||||
|
return name;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void setName(String name) {
|
||||||
|
this.name = name;
|
||||||
|
}
|
||||||
|
|
||||||
|
public GeoPoint getLocation() {
|
||||||
|
return location;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void setLocation(GeoPoint location) {
|
||||||
|
this.location = location;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Indexing your entity with a geo-point :
|
||||||
|
```java
|
||||||
|
elasticsearchTemplate.createIndex(AuthorMarkerEntity.class);
|
||||||
|
elasticsearchTemplate.refresh(AuthorMarkerEntity.class, true);
|
||||||
|
elasticsearchTemplate.putMapping(AuthorMarkerEntity.class);
|
||||||
|
|
||||||
|
List<IndexQuery> indexQueries = new ArrayList<IndexQuery>();
|
||||||
|
indexQueries.add(new AuthorMarkerEntityBuilder("1").name("Franck Marchand").location(45.7806d, 3.0875d).buildIndex());
|
||||||
|
indexQueries.add(new AuthorMarkerEntityBuilder("2").name("Mohsin Husen").location(51.5171d, 0.1062d).buildIndex());
|
||||||
|
indexQueries.add(new AuthorMarkerEntityBuilder("3").name("Rizwan Idrees").location(51.5171d, 0.1062d).buildIndex());
|
||||||
|
elasticsearchTemplate.bulkIndex(indexQueries);
|
||||||
|
```
|
||||||
|
|
||||||
|
For your information :
|
||||||
|
- Clermont-Ferrand : 45.7806, 3.0875
|
||||||
|
- London : 51.5171, 0.1062
|
||||||
|
|
||||||
|
So, if you want to search for authors who are located within 20 kilometers around Clermont-Ferrand, here is the way to build your query :
|
||||||
|
|
||||||
|
```java
|
||||||
|
CriteriaQuery geoLocationCriteriaQuery = new CriteriaQuery(
|
||||||
|
new Criteria("location").within(new GeoPoint(45.7806d, 3.0875d), "20km"));
|
||||||
|
List<AuthorMarkerEntity> geoAuthorsForGeoCriteria = elasticsearchTemplate.queryForList(geoLocationCriteriaQuery, AuthorMarkerEntity.class);
|
||||||
|
```
|
||||||
|
|
||||||
|
This example should only return one author named "Franck Marchand".
|
||||||
|
|
||||||
|
You can even combine with other criteria (e.g. author name) :
|
||||||
|
|
||||||
|
Here, we're looking for authors located within 20 kilometers around London AND named "Mohsin Husen" :
|
||||||
|
|
||||||
|
```java
|
||||||
|
CriteriaQuery geoLocationCriteriaQuery2 = new CriteriaQuery(
|
||||||
|
new Criteria("name").is("Mohsin Husen").and("location").within(new GeoPoint(51.5171d, 0.1062d), "20km"));
|
||||||
|
List<AuthorMarkerEntity> geoAuthorsForGeoCriteria2 = elasticsearchTemplate.queryForList(geoLocationCriteriaQuery2, AuthorMarkerEntity.class);
|
||||||
|
```
|
||||||
|
|
||||||
|
This example should only return one author named "Mohsin Husen".
|
Loading…
x
Reference in New Issue
Block a user