Location API. Included on every plan.

// jQuery UI Autocomplete + StarsAPI Location
$('#birthplace').autocomplete({
  minLength: 2,
  source: function(req, res) {
    $.ajax({
      url: 'https://starsapi.com/include/suggest-location',
      headers: { 'X-Api-Key': 'YOUR_KEY' },
      data: { term: req.term },
      success: function(data) {
        res(data.map(d => ({
          label: d.label,
          value: d.locationid   // jQuery UI needs 'value'
        })));
      }
    });
  },
  select: function(event, ui) {
    $.ajax({
      url: 'https://starsapi.com/include/location-info',
      headers: { 'X-Api-Key': 'YOUR_KEY' },
      data: { id: ui.item.value },
      success: function(loc) {
        // Required for chart endpoints:
        $('#lat').val(loc.latitude);
        $('#lon').val(loc.longitude);
        $('#tz').val(loc.timezone);
        // Optional — for display on reports:
        $('#dms').val(
          loc.lat_deg + '°' + loc.lat_min + '′ ' + (loc.ns ? 'N' : 'S') + ' · ' +
          loc.long_deg + '°' + loc.long_min + '′ ' + (loc.ew ? 'E' : 'W')
        );
      }
    });
  }
});

// React hook — debounced autocomplete
import { useState, useEffect } from 'react';

const API_KEY = 'YOUR_KEY';
const BASE    = 'https://starsapi.com';

function BirthplaceInput({ onSelect }) {
  const [term, setTerm] = useState('');
  const [results, setResults] = useState([]);

  useEffect(() => {
    if (term.length < 2) return setResults([]);
    const t = setTimeout(async () => {
      const r = await fetch(
        `${BASE}/include/suggest-location?term=${encodeURIComponent(term)}`,
        { headers: { 'X-Api-Key': API_KEY } }
      );
      setResults(await r.json());
    }, 250);
    return () => clearTimeout(t);
  }, [term]);

  async function pick(loc) {
    const r = await fetch(
      `${BASE}/include/location-info?id=${loc.locationid}`,
      { headers: { 'X-Api-Key': API_KEY } }
    );
    const info = await r.json();
    // The 3 fields chart endpoints need:
    onSelect({
      latitude:  info.latitude,
      longitude: info.longitude,
      timezone:  info.timezone,
      // Optional — keep info around if you want to show DMS on a report
      _displayInfo: info,
    });
  }

  return (
    <div>
      <input value={term} onChange={e => setTerm(e.target.value)} />
      {results.map(r => (
        <div key={r.locationid} onClick={() => pick(r)}>{r.label}</div>
      ))}
    </div>
  );
}

// Flutter / Dart — using http package
import 'package:http/http.dart' as http;
import 'dart:convert';

const apiKey = 'YOUR_KEY';
const base = 'https://starsapi.com';

class StarsApiLocation {
  Future<List<Map<String, dynamic>>> suggest(String term) async {
    final r = await http.get(
      Uri.parse('$base/include/suggest-location?term=$term'),
      headers: { 'X-Api-Key': apiKey },
    );
    return List<Map<String, dynamic>>.from(jsonDecode(r.body));
  }

  Future<Map<String, dynamic>> details(String locationId) async {
    final r = await http.get(
      Uri.parse('$base/include/location-info?id=$locationId'),
      headers: { 'X-Api-Key': apiKey },
    );
    return jsonDecode(r.body);
  }
}

// Use with TypeAheadField (flutter_typeahead package)
TypeAheadField<Map<String, dynamic>>(
  suggestionsCallback: (q) => q.length >= 2
    ? StarsApiLocation().suggest(q)
    : Future.value([]),
  itemBuilder: (ctx, item) => ListTile(title: Text(item['label'])),
  onSelected: (item) async {
    final info = await StarsApiLocation().details(item['locationid']);
    // 3 fields go to chart endpoints:
    final lat = info['latitude'], lon = info['longitude'], tz = info['timezone'];
    // The rest of `info` is for display (lat_deg, lat_min, ns, ew, etc).
  },
);

// Node.js / Express — server-side proxy
// Useful if you want to keep your API key off the client.
import express from 'express';
import fetch from 'node-fetch';

const app = express();
const API_KEY = process.env.STARSAPI_KEY;
const BASE = 'https://starsapi.com';

app.get('/api/places/suggest', async (req, res) => {
  const r = await fetch(
    `${BASE}/include/suggest-location?term=${encodeURIComponent(req.query.term)}`,
    { headers: { 'X-Api-Key': API_KEY } }
  );
  res.json(await r.json());
});

app.get('/api/places/details/:id', async (req, res) => {
  const r = await fetch(
    `${BASE}/include/location-info?id=${req.params.id}`,
    { headers: { 'X-Api-Key': API_KEY } }
  );
  res.json(await r.json());
});

app.listen(3000);