Skip to content

Latest commit

 

History

History
76 lines (50 loc) · 2.47 KB

README.md

File metadata and controls

76 lines (50 loc) · 2.47 KB

irem

Format, Test and Build | Statements

Search for any place in any language in earth.

Logo

Usage

Use API

Search for "Keçi" in Turkish

Search for "随机" in English (default)

Nearby places around Ankara,Turkiye

Get place by id

Works only in nodejs environment. Stores data in the folder named data in TSV file format or gzipped format or in binary format.

Logo

Use npm

Run command npm i irem

import ESM module

import { getPlaceSuggestionsByText, getNearbyPlaces, getPlaceById } from 'irem';

Documentation

function getPlaceSuggestionsByText

Returns a list of places based on search term in given language. if latitude and longitude is provided, the list is sorted by distance, otherwise sorted by text match. countryCode is a two letters string represents a country such as TR or US. If it's provided, results from the country will have precedence. maxResultCount is the size of returned array length. It should be in [0,100] range If language is undefined, results will be returned in English.

async function getPlaceSuggestionsByText(
  searchTerm: string,
  language?: SupportedLanguage,
  latitude?: number,
  longitude?: number,
  maxResultCount = 10,
  countryCode: CountryCode | "" = "",
): Promise<PlaceMatchWithCountry[]>

function getNearbyPlaces

Returns a list of places based on provided latitude and longitude values in given language. The list is sorted by distance. maxResultCount is the size of returned array length. It should be in [0,100] range

async function getNearbyPlaces(
  latitude: number,
  longitude: number,
  language?: SupportedLanguage,
  maxResultCount = 10,
): Promise<PlaceWithCountry[]>

function getPlaceById

Returns a PlaceWithCountry object from provided id. Id must exist in db.tsv file

async function getPlaceById(placeId: number, language?: SupportedLanguage)

Built for vakit