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.

The Hosted service is perfect for anyone who wants to instantly begin accessing Hivemapper Network’s fresh, high-quality imagery without directly working with the Map Image API.

Get Started

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

Visit Scout and login using the preferred method: Continue with Google. Alternatively, you can link a Phantom account or use an email address with Breeze.

Credits are needed to view imagery with Scout. Once logged in, navigate to Console > Developers and click Purchase Map Credits to load Map Credits into your account.

After checkout, return to Scout and begin uploading locations to monitor.

Upload Locations

Once in Scout, press the Upload button to add locations to the map. Read more about CSV and GeoJSON formatting below. Click Add via Map to add locations via the map.

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

Download the sample CSV shown in the above screenshot

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
              ]
            ]
          ]
        ]
      }
    }
  ]
}

Add Locations via Map

Once in Map, Search the map for any address in the world. Press the Add Location button to populate the Add Location tool directly on the selected address.

Click and drag the Location Pin to manually adjust the desired location. Type in the Location Name, Description (optional), and Tags (Optional, Separated by commas). Hit Save to create the location and add to your list of monitored locations.

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.