Skip to content

Administrative Division Names and Slugs

POST location/names_slugs

Returns the names and the URL slugs for the specified administrative divisions. The end point is in use for the search throw multiple locations either need extra data about locations to get URLs/names for the different languages. Only available in CH.

Request#

Example Request#

The example request contains two parameters: "slugs": ["city-bern"] - it is the slug for the city Bern, and "divisionLevels": [{"divisionLevel": 8,"officialId": 261}] - it is divisionLevel:officialId for the city Zürich. So the example result contains data for the both geolocations.

curl -X POST 'https://api.pricehubble.com/api/v1/location/names_slugs' \
   -H "Authorization: Bearer LWkU3VwcJojIw7O8v8o39IQJPC2ptSdd" \
   -d '{
        "slugs": [
          "city-bern"
        ],
        "divisionLevels": [
          {
            "divisionLevel": 8,
            "officialId": 261
          }
        ]
      }'

Request Fields#

Field Description Type Remarks
slugs Comma-separated list of the URL slugs string Value examples city-zurich, canton-bern. An empty list [] is allowed.
divisionLevels Comma-separated list of {"divisionLevel": divisionLevel, "officialId": officialId} string Value examples {"divisionLevel": 4, "officialId": 3}, {"divisionLevel": 8, "officialId": 261}. An empty list [] is allowed.

*Maximum total ammount of the locations, slugs and divisionLevels is 10

Response#

Example response#

 [
   {
     "name": {
      "de": "Bern",
      "fr": "Berne",
      "it": "Berna",
      "en": "Bern"
     },
     "divisionLevel": {
      "level": 8,
      "designation": "Gemeinde",
      "name": "Bern",
      "officialId": "351"
     },
     "slug": {
      "it": "luogo-berna",
      "fr": "lieu-berne",
      "en": "city-bern",
      "de": "ort-bern"
     },
    "latitude": 46.9479739,
    "longitude": 7.4474468
   },
  {
     "name": {
       "de": "Zürich",
       "fr": "Zurich",
       "it": "Zurigo",
       "en": "Zurich"
     },
    "divisionLevel": {
      "level": 8,
      "designation": "Gemeinde",
      "name": "Zürich",
      "officialId": "261"
    },
     "slug": {
       "it": "luogo-zurigo",
       "fr": "lieu-zurich",
       "en": "city-zurich",
       "de": "ort-zuerich"
     },
     "latitude": 47.3768866,
     "longitude": 8.541694
   }
 ]

Response Fields#

Field Description Type Remarks
divisionLevel The level division Division
name Names of the administrative division in all supported languages Name Supported languages: "de", "en", "it" and "fr"
slug URL slugs of the administrative division in all supported languages Slug Supported languages: "de", "en", "it" and "fr"
latitude Latitude of the center point float
longitude Longitude of the center point float

Name#

Field Description Type Remarks
de Name in German language string
en Name in English language string
fr Name in Franch language string
it Name in Italian language string

Slug#

Field Description Type Remarks
de URL slug for German version string
en URL slug for English version string
fr URL slug for Franch version string
it URL slug for Italian version string