Bản đồ & mùa vụ

Thửa đất, vùng, nông dân, mùa vụ — nền dữ liệu không gian của trang trại.

4 thao tác · gốc /api/v1/gis

GET/api/v1/gis/parcels

Danh sách thửa: mã, diện tích, vùng, cây đang trồng.

Công cụ MCP: farm_list_parcelsPhạm vi: gis.parcels.view

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`page`	int	query	không	Trang (mặc định 1)
`page_size`	int	query	không	Số dòng/trang (tối đa 100)

Ví dụ

curl https://api-prod.nextfarm.vn/api/v1/gis/parcels?page=1&page_size=20 \
  -H "Authorization: Bearer nfk_..."

GET/api/v1/gis/parcels/{id}

Chi tiết một thửa: ranh giới, diện tích, chủ, mùa vụ.

Công cụ MCP: farm_get_parcelPhạm vi: gis.parcels.view

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`id`	GUID	path	có	—

Ví dụ

curl https://api-prod.nextfarm.vn/api/v1/gis/parcels/<id> \
  -H "Authorization: Bearer nfk_..."

GET/api/v1/gis/seasons

Mùa vụ theo năm: cây, thửa, ngày trồng, dự kiến thu hoạch.

Công cụ MCP: farm_list_seasonsPhạm vi: gis.parcels.view

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`year`	int	query	không	Năm, mặc định năm hiện tại

Ví dụ

curl https://api-prod.nextfarm.vn/api/v1/gis/seasons?year=1 \
  -H "Authorization: Bearer nfk_..."

GET/api/v1/gis/search

Tìm thửa, mùa vụ, nông dân, vùng (phần nào thiếu phạm vi thì rỗng).

Công cụ MCP: gis_searchPhạm vi: gis.parcels.view

Tham số

Tham số	Kiểu	Vị trí	Bắt buộc	Mô tả
`q`	string	query	có	Từ khoá, không dấu cũng được

Ví dụ

curl https://api-prod.nextfarm.vn/api/v1/gis/search?q=... \
  -H "Authorization: Bearer nfk_..."