Skip to content

Location & Place

Jump to bottom
Muhammad Azhim Nugroho edited this page Jun 18, 2024 · 7 revisions

This wiki page stores location (city) and place (destination) related APIs.

1. All Locations

  • Endpoint: /locations
  • HTTP Method: GET
  • Authentication: Required

Example Responses:

Status Code: 200
{
    "status": "success",
    "message": "Getting locations successful."
    "data": [
        {
            "location_id": 1,
            "name": "Jakarta",
            "description": "Jakarta, secara resmi bernama Daerah Khusus Ibukota Jakarta (DKI Jakarta), adalah ibu kota Indonesia dan sekaligus daerah otonom setingkat provinsi. Sebelumnya dikenal sebagai Batavia.",
            "photo": "https://images.unsplash.com/photo-1590930754517-64d5fffa06ac?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
        },
        {
            "location_id": 2,
            "name": "Yogyakarta",
            "description": "Kota Yogyakarta, ibu kota sekaligus pusat pemerintahan dan perekonomian dari provinsi Daerah Istimewa Yogyakarta, Indonesia. Kota ini mempertahankan konsep tradisional dan budaya Jawa.",
            "photo": "https://images.unsplash.com/photo-1624936436147-88492b507bc3?q=80&w=2070&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
        },
        {
            "location_id": 3,
            "name": "Bandung",
            "description": "Kota Bandung, sebuah kota sekaligus ibu kota Provinsi Jawa Barat, Indonesia. Kota Bandung juga merupakan kota terbesar keempat di Indonesia, setelah Jakarta, Kota Surabaya, dan Kota Medan.",
            "photo": "https://images.unsplash.com/photo-1564901236182-daaec707fbf3?q=80&w=1974&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
        },
        "__comment": "and so on and so on"
    ]
}
Status Code: 400
{
	"status": "fail",
	"message": "Error getting locations."
}
Status code: 500
{
	"status": "error",
	"message": "Internal server error."
}

2. Location Details

  • Endpoint: /locations/:location_id
  • HTTP Method: GET
  • Authentication: Required

Example Responses:

Status Code: 200
{
    "status": "success",
    "message": "Getting location successful.",
    "data": {
        "name": "Jakarta",
        "description": "Jakarta, secara resmi bernama Daerah Khusus Ibukota Jakarta (DKI Jakarta), adalah ibu kota Indonesia dan sekaligus daerah otonom setingkat provinsi. Sebelumnya dikenal sebagai Batavia.",
        "photo": "https://images.unsplash.com/photo-1590930754517-64d5fffa06ac?q=80&w=1887&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
    }
}
Status Code: 400
{
	"status": "fail",
	"message": "Error getting location."
}
Status code: 500
{
	"status": "error",
	"message": "Internal server error."
}

3. All Places on a Location

  • Endpoint: /locations/:location_id/places
  • HTTP Method: GET
  • Authentication: Required

Example Responses:

Status Code: 200
{
    "status": "success",
    "message": "Getting places within location successful.",
    "data": {
    "places": [
        {
            "place_id": 1,
            "description": "Monumen Nasional atau yang populer disingkat dengan Monas atau Tugu Monas adalah monumen peringatan setinggi 132 meter (433 kaki) yang didirikan untuk mengenang perlawanan dan perjuangan rakyat Indonesia untuk merebut kemerdekaan dari pemerintahan kolonial Hindia Belanda. Pembangunan monumen ini dimulai pada tanggal 17 Agustus 1961 di bawah perintah presiden Soekarno dan dibuka untuk umum pada tanggal 12 Juli 1975. Tugu ini dimahkotai lidah api yang dilapisi lembaran emas yang melambangkan semangat perjuangan yang menyala-nyala. Monumen Nasional terletak tepat di tengah Lapangan Medan Merdeka, Jakarta Pusat.",
            "category": "Budaya",
            "maps": "https://www.google.com/maps/@-6.1753924,106.8271528,15z"
        },
        {
            "place_id": 2,
            "description": "Kota tua di Jakarta, yang juga bernama Kota Tua, berpusat di Alun-Alun Fatahillah, yaitu alun-alun yang ramai dengan pertunjukan rutin tarian tradisional. Museum Sejarah Jakarta adalah bangunan era Belanda dengan lukisan dan barang antik, sedangkan Museum Wayang memamerkan boneka kayu khas Jawa. Desa Glodok, atau Chinatown, terkenal dengan makanan kaki lima, seperti pangsit dan mi goreng. Di dekatnya, terdapat sekunar dan kapal penangkap ikan di pelabuhan Sunda Kelapa yang kuno",
            "category": "Budaya",
            "maps": "https://www.google.com/maps/@-6.137644799999999,106.8171245,15z"
        },
        {
            "place_id": 3,
            "description": "Dunia Fantasi atau disebut juga Dufan adalah tempat hiburan yang terletak di kawasan Taman Impian Jaya Ancol, Jakarta Utara, Indonesia. Dufan diresmikan dan dibuka pada tanggal 29 Agustus 1985.",
            "category": "Taman Hiburan",
            "maps": "https://www.google.com/maps/@-6.125312399999999,106.8335377,15z"
        },
        "__comment": "and so on and so on"
    ]
}
Status Code: 400
{
	"status": "fail",
	"message": "Error getting places within location."
}
Status code: 500
{
	"status": "error",
	"message": "Internal server error."
}

4. Place Details

  • Endpoint: /places/:place_id
  • HTTP Method: GET
  • Authentication: Required

Example Responses:

Status Code: 200
{
    "status": "success",
    "message": "Getting place successful.",
    "data": {
        "name": "Monumen Nasional",
        "description": "Monumen Nasional atau yang populer disingkat dengan Monas atau Tugu Monas adalah monumen peringatan setinggi 132 meter (433 kaki) yang didirikan untuk mengenang perlawanan dan perjuangan rakyat Indonesia untuk merebut kemerdekaan dari pemerintahan kolonial Hindia Belanda. Pembangunan monumen ini dimulai pada tanggal 17 Agustus 1961 di bawah perintah presiden Soekarno dan dibuka untuk umum pada tanggal 12 Juli 1975. Tugu ini dimahkotai lidah api yang dilapisi lembaran emas yang melambangkan semangat perjuangan yang menyala-nyala. Monumen Nasional terletak tepat di tengah Lapangan Medan Merdeka, Jakarta Pusat.",
        "category": "Budaya",
        "location_id": 1,
        "location_name": "Jakarta",
        "maps": "https://www.google.com/maps/@-6.1753924,106.8271528,15z"
    }
}
Status Code: 400
{
	"status": "fail",
	"message": "Error getting place."
}
Status code: 500
{
	"status": "error",
	"message": "Internal server error."
}

Clone this wiki locally