Place

Every result yielded by places.search and places.stream is a Place — a single flat object with 27 fields, where everything OpenPlaces can parse is surfaced directly rather than nested behind sub-resources.

Place is a Zod schema exported from the package root, and the TypeScript type is inferred from it. You can use the schema to validate data that crosses a process or serialization boundary:

import { Place } from "openplaces";

const place = Place.parse(data); // throws if the shape is invalid
const checked = Place.safeParse(data); // { success, data } | { success, error }

Internally, every parsed candidate goes through Place.safeParse and is dropped on failure — anything the library yields already conforms to this schema, and fields that could not be parsed are absent, not null.

Fields