Scout Hosted Service

The easiest way to start monitoring locations

Introduction

Hivemapper offers two versions of Scout: an open-source UI Library and a hosted service.

This service is perfect for anyone who wants to view fresh, high-quality imagery from the Hivemapper Network but prefers not to work directly with the Map Image API.

Get Started

Already signed in and have credits? Jump to CSV example or GeoJSON examples.

Visit the Map Data Console and press Sign In With Google to create an account or sign into an existing one.

Credits are needed to view imagery with Scout. Once logged in, press the Buy Credits button to load your account. After the checkout procedure, return to the Map Data Console and press Get Started in the Scout section. Alternatively, go directly to https://hivemapper.com/scout.

Upload Locations

Once in Scout, press the Upload button in the top right corner to add locations to the map.

Map view of Scout prior to uploading any locations

The following upload formats are supported:

• CSV

• GeoJSON

The following types of locations are supported:

• Address

• Point (Coordinate pair)

• Polygon

• MultiPolygon

The following attributes/properties are supported:

• location: the location you want to Scout formatted as an Address, Point, Polygon or MultiPolygon

• type: differentiates between the types of locations (Address, Point, Polygon or MultiPolygon), especially when multiple types are included in the same upload

• name: preferred identifier for this location

• description: additional details about this location

• tags: labels for grouping and filtering locations

CSV Format

The location attribute is the only one required for a CSV upload.

In a spreadsheet, include the location header. In the rows below, list the addresses or coordinates you want to Scout. Coordinates should be presented as lat, long.

Location with addresses

Location with coordinates

Users can also upload a CSV including Polygons or MultiPolygons so long as the coordinates are properly formatted.

Sample format for Polygon and MultiPolygon

Optionally, more information can be included about each location. The user can choose to include name, description or tags. Keep in mind:

• If any additional attributes besides location are included, type must also be specified.

• It is possible to include a mixture of types (e.g. both address and point) in the same upload, but type must be specified for each.

• Multiple tags must be separated with a comma.

Sample locations with all optional attributes included

Example CSV

805B

ScoutSample.csv

GeoJSON Format

The minimum requirements for a GeoJSON upload include the location geometry and type as well as the name property. The description and tags are optional.

Example Polygon

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "properties": {
              "name": "Central Ave",
              "description": "Monitoring this location for project 1",
              "tags": ["project1", "Phoenix"]
            },
            "geometry": {
              "type": "Polygon",
              "coordinates": [
                [
                  [
                    -112.0741711,
                    33.4728381
                  ],
                  [
                    -112.0734685,
                    33.4728319
                  ],
                  [
                    -112.0735055,
                    33.4712155
                  ],
                  [
                    -112.0741859,
                    33.4712155
                  ],
                  [
                    -112.0741711,
                    33.4728381
                  ]
                ]
              ]
            }
          }
    ]
}

Example MultiPolygon

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "name": "Central Ave",
        "description": "Monitoring this location for project 1",
        "tags": ["project1", "Phoenix"]
      },
      "geometry": {
        "type": "MultiPolygon",
        "coordinates": [
          [
            [
              [
                -112.0741711,
                33.4728381
              ],
              [
                -112.0734685,
                33.4728319
              ],
              [
                -112.0735055,
                33.4712155
              ],
              [
                -112.0741859,
                33.4712155
              ],
              [
                -112.0741711,
                33.4728381
              ]
            ]
          ],
          [
            [
              [
                -112.07418103422795,
                33.46749014499196
              ],
              [
                -112.07347843422795,
                33.46748394499197
              ],
              [
                -112.07351543422794,
                33.465867544991966
              ],
              [
                -112.07419583422795,
                33.465867544991966
              ],
              [
                -112.07418103422795,
                33.46749014499196
              ]
            ]
          ]
        ]
      }
    }
  ]
}

Start Scouting

Once the CSV or GeoJSON is uploaded, Scout will fetch imagery from the last two weeks from the designated locations. Credits will only be deducted from your balance if images are returned for the monitored locations.