---
title: "Add a Place"
method: POST
path: "/multigeocode/place"
tags: ["Places_Multi-Geocode"]
---

# Add a Place

`POST /multigeocode/place`

The "Add Place" method allows users to create custom places

Add place method provides the flexibility to create custom places in a way that suits your business needs. The newly created place and its attributes can be added to custom (proprietary) dataset - to the effect of building your own places dataset (s) - or, to a default dataset. Overcome inaccurate ‘POI’ details from default search provider by creating custom, highly accurate ‘POIs’.

## Query parameters

- `key` string, 32 character alphanumeric string, required

## Request body

- object
  - `place` object[], required — This parameter represents the place details, including geographical information, address and other related information.
    - `geopoint` object, required — This parameter represents the geographical coordinates of the place. It includes the latitude and longitude values.
      - `lat` number — This parameter represents the latitude value of the place.
      - `lng` number — This parameter represents the longitude value of the place.
    - `country` string — Country of the search context provided as comma-separated [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) country codes. Note: Country codes should be provided in uppercase.
    - `state` string — This parameter represents the state or region of the place.
    - `city` string — This parameter represents the city or town of the place.
    - `district` string — This parameter represents the district of the place.
    - `subDistrict` string — This parameter represents the sub-district or locality of the place.
    - `street` string — This parameter represents the street name of the place.
    - `postalCode` string — This parameter represents the postal code or ZIP code of the place.
    - `house` string — This parameter represents the house or building number of the place.
    - `building` string — This parameter represents additional building information if applicable.
    - `poi` object — This parameter represents a point of interest within the place. A Point of Interest (POI) refers to a specific location or area that is of interest to individuals for various reasons. It could be a landmark, tourist attraction, business, or any other location that people might find important or intriguing.
      - `title` string — A title that describes the point of interest.
    - `address` string — This parameter represents the complete address of the place, including the street, city, state, postal code and country.
  - `dataSource` DataSource — It contains information about the dataset that returns the specific result
    - `source` string — This parameter represents the source of the data.
    - `refId` string — This parameter represents the unique reference ID associated with the data source.
    - `status` 'enable' | 'disable' — This parameter indicates if a place is searchable.
  - `score` integer — Search score of the place. This is calculated based on how ‘richly’ the place is defined. For instance, a place with - street name, city, state and country attributes set might be ranked lower than a place which has values of - house, building, street name, city, state and country attributes set. The score determines the rank of the place among search results. You can also use this field to set a custom score as per its relevance to rank it among the search results from multiple data sources.
  - `force` boolean — When 2 places are located within 100 meters of each other and have more than 90% of matching attributes (at least 11 out of 12 attributes in the “place” object), they will be considered duplicates and any requests to add such a new place would be rejected. Set force=true to override this duplicate check. You can use this to create closely located POIs. For instance, places inside a mall, university or a government building etc.

## Response `200`

- object
  - `docId` string — A unique NextBillion DocID will be created for the POI. Use this ID to search this place through the “Get Place” method, to update attributes or ‘status’ through the “Update Place” method or delete it using the “Delete Place” method.

---

[API](https://skmtc.net/nextbillion-ai/apis/one-spec-service.md) · [All operations](https://skmtc.net/nextbillion-ai/apis/one-spec-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nextbillion-ai/one-spec-service/versions/b647f1808dda/schema)