gistda-sphere-react

Search and places

Keyword search, autocomplete, nearby places, place details, POIs per tile and tag categories

These services search Sphere's place database. On a map, useSearch does the same through the map. The methods below need no map.

const { data, meta } = await services.search.search("โรงพยาบาล", {
  near: { lon: 100.5383, lat: 13.7649 },
  showDistance: true,
  limit: 10,
});

for (const place of data) {
  console.log(place.name, place.address, place.distance);
}
OptionTypeDescription
limit, offsetnumberPaging. meta.hasmore tells you if there's more.
nearLocationPrefer results around this location.
showDistancebooleanInclude distance (meters) from near in each result.
tagstring | string[]Only places with these tags.
locale"th" | "en"Language of names and addresses.

Autocomplete

const { data } = await services.search.suggest("เซ็นทรัล", { limit: 5, soundex: true });
// data: [{ name: "เซ็นทรัลเวิลด์", highlight: "<b>เซ็นทรัล</b>เวิลด์" }, …]

soundex: true also suggests words that sound alike, which helps with misspellings.

Nearby places

const { data } = await services.poi.nearby(
  { lon: 100.5383, lat: 13.7649 },
  { span: "1km", tag: "คอฟฟี่ช็อป", limit: 20 }
);
OptionTypeDescription
spanstringSearch radius with a unit: "500m", "1km", "0.01deg".
tagstring | string[]Only places with these tags.
limit, offset, localeAs for search.

Place details

const place = await services.poi.get("P00000046", { locale: "en" });
console.log(place.name, place.tel, place.url);
// Areas such as "A10000000" (Bangkok) include their outline in `place.geo`.

To draw a place's outline on a map, use <ObjectOverlay>.

POIs per map tile

const items = await services.poi.cluster({ z: 12, x: 3191, y: 1889 }, { tag: "โรงพยาบาล" });

Returns the POIs in one web-mercator tile, which is useful for drawing POIs with your own map library.

Tag categories

const categories = await services.tags.categories();
// [{ name: { th: "อาหาร", en: "Food" }, icon: "food", sub: [{ name: { th: "อาหารไทย", en: "Thai" } }, …] }, …]

This list is public and doesn't need an API key. In React, useTagCategories loads it for you.

On this page