Errors

Every error has the same shape, and its HTTP status matches its type:

• error object required
  • type string required

    one of invalid_request, authentication_error, permission_error, not_found, conflict, rate_limit, api_error

  • code string required

    one of invalid_parameter, missing_parameter, unsupported_date_range, invalid_api_key, key_revoked, scope_not_allowed, plan_restricted, domain_not_allowed, not_found, idempotency_conflict, place_ambiguous, place_not_found, rate_limited, quota_exhausted, internal_error, engine_unavailable, timeout, time_required

  • message string required
  • param string
  • issues array of object
    Fields

    • param string required
    • message string required
  • candidates array of object
    Fields

    • place_id string required
    • name string required
    • state string
    • country string
  • request_id string required
  • doc_url string (uri) required

• issues lists every problem in the request at once.
• candidates comes with place_ambiguous.
• request_id: quote it when you write to us.
• doc_url links to the row for its code below.

Errors are never charged.

Error codes