Read your Geosearch usage and how it is billed

Usage under Geosearch lists what the account has used each day. The tab appears once Geosearch is turned on.

Column What it counts
Billing period The month the day falls in. It shows once for each month.
Date The day the usage was recorded.
Place requests Address lookups the booking form made through Formpiece.
Address geolookups Addresses turned into coordinates, such as scheduled sites and employee and contractor addresses.
Route requests Travel times and routes worked out for dynamic travel times.

Newest days come first, and days with no usage have no row. The page notes that the billing period is in the Australian Eastern Standard Time timezone. With no history it reads "No usage has been previously billed.", and "Usage records not retrieved yet." if the records could not be loaded.

The page shows counts only. It does not show a cost.

How usage reaches billing

Each use of one of the three kinds is logged as it happens. Formpiece then totals the logged uses into one record for each kind and day, and that is the row you see here. It does this for the most recent days, three by default, and makes each record once.

A second job sends each new record to Stripe as metered usage against the account's Stripe customer, one event per kind per day, using the day's count. It needs a Stripe billing customer for the account. Without one the usage is recorded and nothing is sent.

What makes usage

  • A scheduled site, or an employee's or contractor's address, is looked up the first time it is seen. A site or address that already has coordinates is not looked up again. Sync employees and Sync contractors on the Setup tab can start lookups, and so can Check site on a bulk filter.
  • A customer choosing an address in a booking form's address search makes a place request.
  • A form that books by dynamic travel times makes route requests for each date it checks. Search Diagnostics makes the same requests when Check dynamic travel times is on, and says "Each one adds to your Georoute usage."

When it goes wrong

A recent day has no row

The daily records are made by a scheduled job that looks back over the last few days, so a very recent day may not be there yet. A day with no usage never has a row.