API Place details

Giới thiệu

Place detail là API cho phép người dùng truyền vào place_id (là đầu ra từ API Autocomplete phía bên trên), khi đó kết quả trả về là toạ độ (latitude/longitude) của place_id vừa truyền.

Params

GET https://dev.toptopmap.com/api/v1/maps/place/details?key=APIKey&place_id=EkxOZy4gMiBQLiBOZ3V54buFbiBIb8OgbmcsIE3hu7kgxJDDrG5oIDIsIEPhuqd1IEdp4bqleSwgSMOgIE7hu5lpLCBWaeG7h3QgTmFtIi4qLAoUChIJAfVOyrNUNDERfTpoOim2STgSFAoSCTvnxbi6VDQxEcRmuqaNMPMV&language=vi

Parameter	Type	Description
key	string	Required. API Key lấy từ TOPTOP Maps
place_id	string	Required. Place ID lấy từ Autocomplete

Request mẫu

curl --location 'https://dev.toptopmap.com/api/v1/maps/place/details?key=APIKey&place_id=EkxOZy4gMiBQLiBOZ3V54buFbiBIb8OgbmcsIE3hu7kgxJDDrG5oIDIsIEPhuqd1IEdp4bqleSwgSMOgIE7hu5lpLCBWaeG7h3QgTmFtIi4qLAoUChIJAfVOyrNUNDERfTpoOim2STgSFAoSCTvnxbi6VDQxEcRmuqaNMPMV&language=vi'

Responses

{
    "status": "OK",
    "result": {
        "geometry": {
            "location": {
                "lat": "21.029964",
                "lng": "105.7777154"
            },
            "viewport": {
                "northeast": {
                    "lat": "21.0313129802915",
                    "lng": "105.7790643802915"
                },
                "southwest": {
                    "lat": "21.0286150197085",
                    "lng": "105.7763664197085"
                }
            }
        },
        "formatted_address": "Ngõ 2 Phố Nguyễn Hoàng, Mỹ Đình 2, Từ Liêm, Hà Nội, Việt Nam",
        "name": "Ngõ 2 Phố Nguyễn Hoàng",
        "address_components": [
            {
                "long_name": "Ngõ 2 Phố Nguyễn Hoàng",
                "short_name": "Ng. 2 P. Nguyễn Hoàng",
                "types": [
                    "route"
                ]
            },
            {
                "long_name": "Mỹ Đình 2",
                "short_name": "Mỹ Đình 2",
                "types": [
                    "sublocality_level_1",
                    "sublocality",
                    "political"
                ]
            },
            {
                "long_name": "Từ Liêm",
                "short_name": "Từ Liêm",
                "types": [
                    "administrative_area_level_2",
                    "political"
                ]
            },
            {
                "long_name": "Hà Nội",
                "short_name": "Hà Nội",
                "types": [
                    "administrative_area_level_1",
                    "political"
                ]
            },
            {
                "long_name": "Việt Nam",
                "short_name": "VN",
                "types": [
                    "country",
                    "political"
                ]
            }
        ],
        "place_id": "EkdOZy4gMiBQLiBOZ3V54buFbiBIb8OgbmcsIE3hu7kgxJDDrG5oIDIsIFThu6sgTGnDqm0sIEjDoCBO4buZaSwgVmlldG5hbSIuKiwKFAoSCQH1TsqzVDQxEX06aDoptkk4EhQKEgk758W4ulQ0MRHEZrqmjTDzFQ",
        "detail": {},
        "gate": null,
        "adr_address": "<span class=\"street-address\">Ng. 2 P. Nguyễn Hoàng</span>, <span class=\"extended-address\">Mỹ Đình 2</span>, <span class=\"locality\">Từ Liêm</span>, <span class=\"region\">Hà Nội</span>, <span class=\"country-name\">Việt Nam</span>",
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "plus_code": {},
        "reference": "EkdOZy4gMiBQLiBOZ3V54buFbiBIb8OgbmcsIE3hu7kgxJDDrG5oIDIsIFThu6sgTGnDqm0sIEjDoCBO4buZaSwgVmlldG5hbSIuKiwKFAoSCQH1TsqzVDQxEX06aDoptkk4EhQKEgk758W4ulQ0MRHEZrqmjTDzFQ",
        "secondary_text": "Ngõ 2 Phố Nguyễn Hoàng, Mỹ Đình 2, Từ Liêm, Hà Nội, Việt Nam",
        "types": [
            "route"
        ],
        "url": "https://maps.google.com/?q=Ng.+2+P.+Nguy%E1%BB%85n+Ho%C3%A0ng,+M%E1%BB%B9+%C4%90%C3%ACnh+2,+T%E1%BB%AB+Li%C3%AAm,+H%C3%A0+N%E1%BB%99i,+Vi%E1%BB%87t+Nam&ftid=0x313454b3ca4ef501:0x3849b6293a683a7d",
        "utc_offset": 420,
        "vicinity": "Mỹ Đình 2"
    }
}

Status Codes

Status Code	Description
200	OK
400	BAD REQUEST
404	NOT FOUND
500	INTERNAL SERVER ERROR