## 地理坐標點 _地理坐標點（geo-point）_ 是指地球表面可以用經緯度描述的一個點。地理坐標點可以用來計算兩個坐標位置間的距離，或者判斷一個點是否在一個區域中。 地理坐標點不能被動態映射（dynamic mapping）自動檢測，而是需要顯式聲明對應字段類型為 `geo_point` 。 ```json PUT /attractions { "mappings": { "restaurant": { "properties": { "name": { "type": "string" }, "location": { "type": "geo_point" } } } } } ``` ### 經緯度坐標格式 如上例，`location` 被聲明為 `geo_point` 后，我們就可以索引包含了經緯度信息的文檔了。經緯度信息的形式可以是字符串，數組或者對象。 ```json PUT /attractions/restaurant/1 { "name": "Chipotle Mexican Grill", "location": "40.715, -74.011" <1> } PUT /attractions/restaurant/2 { "name": "Pala Pizza", "location": { <2> "lat": 40.722, "lon": -73.989 } } PUT /attractions/restaurant/3 { "name": "Mini Munchies Pizza", "location": [ -73.983, 40.719 ] <3> } ``` - <1> 以半角逗號分割的字符串形式 `"lat,lon"`； - <2> 明確以 `lat` 和 `lon` 作為屬性的對象； - <3> 數組形式表示 `[lon,lat]`。 > 注意 > 可能所有人都至少踩過一次這個坑：地理坐標點用字符串形式表示時是緯度在前，經度在后（`"latitude,longitude"`），而數組形式表示時剛好相反，是經度在前，緯度在后（`[longitude,latitude]`）。 > 其實，在 Elasticesearch 內部，不管字符串形式還是數組形式，都是緯度在前，經度在后。不過早期為了適配 GeoJSON 的格式規范，調整了數組形式的表示方式。 > 因此，在使用地理位置（geolocation）的路上就出現了這么一個“捕熊器”，專坑那些不了解這個陷阱的使用者。