Billing Setup

Geog offers a generous free tier for evaluation and development. When you're ready for production workloads, set up billing to remove rate limits and access higher usage tiers.

Free Tier

Every organization starts on the free tier with the following daily limits:

ResourceDaily Limit
Vector tile requests1,000
Places API requests100

Limits reset daily at 00:00 UTC. Free tier requests include rate limit headers so you can monitor your usage programmatically:

X-RateLimit-Tiles-Limit: 1000
X-RateLimit-Tiles-Remaining: 742
X-RateLimit-Tiles-Reset: 2025-01-15T00:00:00Z

X-RateLimit-Places-Limit: 100
X-RateLimit-Places-Remaining: 85
X-RateLimit-Places-Reset: 2025-01-15T00:00:00Z

The free tier is ideal for development, testing, and small projects. No credit card is required.

Setting Up Billing

Setting up billing is a 3-step process. Only organization owners can manage billing.

Step 1: Contact Information

  1. Go to Billing in the console sidebar
  2. Click Set Up Billing
  3. Enter your organization's billing email and name
  4. Click Continue

This creates your billing customer record.

Step 2: Billing Contact

  1. Confirm or update the billing contact email
  2. This email receives invoices and billing notifications

Step 3: Payment Method

  1. Click Add Payment Method
  2. You'll be redirected to a secure Stripe checkout page
  3. Enter your card details
  4. Click Save

Once complete, rate limits are removed and you have unlimited API access. Usage is tracked and billed at the end of each billing period.

Viewing Usage

All organization members can view usage data:

  1. Go to Usage in the console sidebar (or view the dashboard summary)
  2. See a breakdown of:
    • Vector tile requests — Total tile API calls
    • Places API requests — Total places search calls
    • Period — Current billing period dates

Usage data is updated in near real-time via Workers Analytics Engine.

Viewing Invoices

  1. Go to Billing in the console sidebar
  2. Scroll to the Invoices section
  3. Click any invoice to view details or download a PDF

Managing Your Subscription

Owners can manage their subscription through the Stripe Customer Portal:

  1. Go to Billing in the console sidebar
  2. Click Manage Subscription
  3. You'll be redirected to the Stripe portal where you can:
    • Update payment methods
    • View billing history
    • Download invoices
    • Cancel your subscription

Billing Permissions

ActionOwnerAdminMember
Set up billing✅——
Manage payment methods✅——
Manage subscription✅——
View billing info & invoices✅✅✅
View usage data✅✅✅

If you need billing access, ask an organization owner to either manage it on your behalf or change your role. See Roles & Permissions for the full permission reference.

Next Steps