Skip to content
Developers
Get an API token

Get the land survey grid in a bbox

Texas original land survey lines and labels inside bbox: the county, block, section and abstract lines landmen lease by, as the Railroad Commission of Texas (RRC) maps them, to draw under wells and pads.

Get the land survey grid in a bbox

GET/land-grid

Texas original land survey lines and labels inside bbox: the county, block, section and abstract lines landmen lease by, as the Railroad Commission of Texas (RRC) maps them, to draw under wells and pads.

Send a Novi API token as a bearer token on every request. Authentication
Levels

level picks how fine: block gives county and block lines and a label per block in each county it spans; section (the default) adds section and survey lines and numbers; abstract adds abstract lines and numbers. A label's text gives its form.

What you get

One MultiLineString feature per kind of line (properties.line), with each line whose extent overlaps the bbox whole, not clipped, and Point labels inside the bbox, each inside its largest parcel. coverage lists the counties the grid holds (outside them every answer is empty), and source says where it comes from and its date. The lines are digitized from General Land Office maps in NAD27 and shifted to NAD83: a picture to plan by, not a legal survey. Every model set answers alike, from the default dataset.

Limits

The bbox's area, width × height in square degrees, is capped per level: block 16, section 1, abstract 1; past it, a 400 names the cap. Fetch blocks for a whole county or more, sections and abstracts for a few townships. A dataset without the land grid is a 503.

Parameters

Query parameters

  • bboxstringRequired

    west,south,east,north in degrees, west < east and south < north; its area may be at most 16 square degrees at block, 1 square degrees at section, 1 square degrees at abstract.

  • levelstringOptional

    Default "section"

    block: county and block lines with block labels; section (default): adds section lines and numbers; abstract: adds abstract division lines and numbers.

    "block""section""abstract"

Responses

200 OK

The lines and labels in the bbox.

  • typestringRequired

    FeatureCollection.

    "FeatureCollection"
  • levelstringRequired

    The level asked for.

    "block""section""abstract"
  • bboxarray of numbersRequired

    4 items

    The bbox asked for, as [west, south, east, north].

  • coverageobjectRequired

    Where the grid has data.

    ShowHide 2 child fields
    • statestringRequired

      TX.

      "TX"
    • countiesarray of stringsRequired

      Items pattern ^\d{3}$

      The counties the grid holds, ascending, whatever the bbox.

  • sourcestringRequired

    Where the grid comes from and its date (the RRC grid's download date, the sample's as-of date), how it was shifted, and that it is not a legal survey.

  • featuresarray of objectsRequired

    Lines first, one feature per kind from county to abstract, then labels.

    ShowHide 2 variants in each item

    One of

    • LandGridLine object

      One kind of survey line.

      • typestringRequired

        Feature.

        "Feature"
      • geometryobjectRequired

        Every line of this kind whose extent overlaps the bbox, whole.

        ShowHide 2 child fields
        • typestringRequired

          MultiLineString.

          "MultiLineString"
        • coordinatesarray of arraysRequired

          Items at least 2 items

          The lines.

      • propertiesobjectRequired

        What the lines are.

        ShowHide 2 child fields
        • kindstringRequired

          line.

          "line"
        • linestringRequired

          county: a county boundary; block: a block line; section: a section or survey line; abstract: an abstract division line.

          "county""block""section""abstract"
    • LandGridLabel object

      A survey label.

      • typestringRequired

        Feature.

        "Feature"
      • geometryobjectRequired

        Where the label goes: inside its largest parcel.

        ShowHide 2 child fields
        • typestringRequired

          Point.

          "Point"
        • coordinates[number, number]Required

          A point as [longitude, latitude] in WGS 84 degrees.

      • propertiesobjectRequired

        The label and the parcel it names.

        ShowHide 8 child fields
        • kindstringRequired

          label.

          "label"
        • levelstringRequired

          The level the label belongs to, as asked.

          "block""section""abstract"
        • textstringRequired

          What to show: "<survey> Blk <block>" (once in each county a block spans), the section number (else the survey name), or "A-" and the abstract number.

        • county_fipsstringRequired

          pattern ^\d{3}$

          Texas county FIPS code (3 digits): for an abstract the county it is recorded in, else the county it lies in.

        • abstractstring or nullRequired

          Abstract number, without "A-" (abstract labels).

        • surveystring or nullRequired

          Survey name, as the RRC writes it.

        • blockstring or nullRequired

          Block, as the RRC writes it (block and finer labels).

        • sectionstring or nullRequired

          Section number (section and abstract labels).

Conditional requests 304 Unchanged since the ETag in If-None-Match.

Errors

Shared errors400401403500503What they mean