---
title: "Update Place"
method: PUT
path: "/multigeocode/place/{docId}"
tags: ["Places_Multi-Geocode"]
---

# Update Place

`PUT /multigeocode/place/{docId}`

The "Update Place" method allows businesses to update the attributes of an existing place.

This method allows you to update the attributes of custom places. In effect, updating a place replaces the current information in search results with the updated information associated with the specific docID. Use this method to enhance the accuracy/usability of your search results with respect to the default dataset to suit your business needs.


If you want to prioritize a particular result in your search results, update the ‘score’ of that specific place.    
Alternatively, you can block places which are no longer needed by setting their status: ‘disable’.

## Path parameters

- `docId` string, required

## Query parameters

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

## Request body

- object
  - `place` object[] — This parameter represents the place details, including geographical information, address and other related information.
    - `geopoint` object — 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 — This parameter represents the country of the place.
    - `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` object — dataSource values can be updated to enhance or prioritize the search results to better suit specific business use cases.
    - `source` string — 1. Move the place to a new dataset by setting the value to a unique dataset name. You can also move the place to an existing dataset by using an existing dataset name other than the current one. In both cases, the current datasource will be replaced for the specified docID. 2. Update the place in an existing dataset by setting the name to the current value.
    - `refId` string — This parameter represents the unique reference ID associated with the data source.
    - `status` 'enable' | 'disable' — Set this to either enable or disable to allow the place to be retrieved by a search API or block it respectively.
  - `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.

## Response `200`

- object
  - `status` string — Represents the status of the response.
  - `msg` string — This could be “Ok” representing success or “not found” representing error in processing the request.

---

[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)