Skip to end of metadata
Go to start of metadata

This documentation is no longer actively supported and may be out of date. Going forward, please visit and bookmark our new site (https://docs.phunware.com/) for up-to-date documentation.

Retrieve a Floor

 

This method is used to retrieve a floor by floor ID.

Method

GET

URL

http://map-api.phunware.com/v1.1/floors/[id]

Headers

X-Auth (see Security)

Query Parameters

Required parameters are underlined.

Parameter

Value

Description

draftStatus

string

Either "LIVE" or "DRAFT". Defaults to "LIVE".

 

Example Request

GET
http://map-api.phunware.com/v1.1/floors/17 

Response

A successful response will have a 200 status code and a body containing an object with floor data:

{
    "id": <integer>
    "venueGuid": <string>,
    "buildingId": <integer>,
    "name": <string>,
    "originalMapUrl": <string>,
    "level": <integer>,
    "isOutdoor": <Boolean>,
    "width": <integer>,
    "height": <integer>,
    "offsetX": <integer>,
    "offsetY": <integer>,
    "locationMapHierarchy": <string>,
    "maxZoomLevel": <integer>,
    "referencePoints": 
	{
        "rotation": <integer>,
        "portal": 
		{
            "topRight": 
			{
                "latitude": <decimal>,
                "longitude": <decimal>
            },
            "bottomLeft": 
			{
                "latitude": <decimal>,
                "longitude": <decimal>
            }
        },
        "topLeft": 
		{
            "latitude": <decimal>,
            "longitude": <decimal>
        },
        "topRight": 
		{
            "latitude": <decimal>,
            "longitude": <decimal>
        },
        "bottomLeft": 
		{
            "latitude": <decimal>,
            "longitude": <decimal>
        },
        "bottomRight": 
		{
            "latitude": <decimal>,
            "longitude": <decimal>
		}
    },
    "externalId": <integer>
}

See Mapping API Response Handling for error payloads.

Example Response

Example body of a successful response:

{
    "id": 17
    "venueGuid": "03521872-2845-4024-896d-5fa0ab555c12",
    "buildingId": 6891,
    "name": "Level One",
    "originalMapUrl": "http://image.com/level1.pdf",
    "level": 1,
    "isOutdoor": false,
    "width": 100,
    "height": 200,
    "offsetX": 0,
    "offsetY": 0,
    "locationMapHierarchy": "somecampus>somebuilding>somefloor",
    "maxZoomLevel": 3,
    "referencePoints": 
	{
        "rotation": 214,
        "portal": 
		{
            "topRight": 
			{
                "latitude": 33.77403309960294,
                "longitude": -84.32867120304763
            },
            "bottomLeft": 
			{
                "latitude": 33.7740738782866,
                "longitude": -84.32673443277963
            }
        },
        "topLeft": 
		{
            "latitude": 33.773309,
            "longitude": -84.327331
        },
        "topRight": 
		{
            "latitude": 33.774033,
            "longitude": -84.328671
        },
        "bottomLeft": 
		{
            "latitude": 33.774073,
            "longitude": -84.326734
        },
        "bottomRight": 
		{
            "latitude": 33.774797,
            "longitude": -84.328074
        }
    },
    "externalId": 17
} 

ON THIS PAGE

 

 

  • No labels