Resolve ambiguous locations

When a place name has multiple matches, Astrotechne returns bounded candidates and does not calculate or consume chart quota. Repeat the request with a more specific placeQuery or explicit coordinates.

Request and response shapes

Input shape

{ placeQuery: string }

Output shape

{ code: 'disambiguation_required'; candidates: Array<{ label: string; latitude: number; longitude: number }> }

Examples

Request example

{
  "localDate": "1990-01-15",
  "localTime": "06:30",
  "placeQuery": "Springfield"
}

Response example

{
  "code": "disambiguation_required",
  "candidates": [
    {
      "label": "Springfield, Illinois, USA"
    }
  ]
}

Common validation errors

No calculation occurs until one location is unambiguous.

Resolve ambiguous locations

Request and response shapes

Input shape

{ placeQuery: string }

Output shape

{ code: 'disambiguation_required'; candidates: Array<{ label: string; latitude: number; longitude: number }> }

Examples

Request example

{
  "localDate": "1990-01-15",
  "localTime": "06:30",
  "placeQuery": "Springfield"
}

Response example

{
  "code": "disambiguation_required",
  "candidates": [
    {
      "label": "Springfield, Illinois, USA"
    }
  ]
}

Common validation errors

No calculation occurs until one location is unambiguous.

Resolve ambiguous locations

Request and response shapes

Input shape

Output shape

Examples

Request example

Response example

Common validation errors

Related questions

Resolve ambiguous locations

Request and response shapes

Input shape

Output shape

Examples

Request example

Response example

Common validation errors

Related questions