---
# System prepended metadata

title: Market Share Data

---


# Market Share Data

## current data from listing-editor

```json=
{
    "meta": {
        "total": 11452980,
        "count": 1
    },
    "data": [
        {
            "_index": "kwlslistings",
            "_type": "record",
            "_id": "211aa267-c8b9-4046-a9e1-e2fd949a3e0a",
            "_score": 1,
            "_source": {
                "hoa": [
                    {
                        "assoc_fee": 550,
                        "assoc_fee_freq": "Monthly"
                    }
                ],
                "raw": {
                    "prop_type": "Attached Single",
                    "list_status": "Active",
                    "prop_type_id": 2,
                    "parking_total": "2",
                    "list_status_id": 1,
                    "source_list_id": "200_2146574179"
                },
                "kw_mc": false,
                "taxes": [
                    {
                        "tax_year": "2017"
                    }
                ],
                "mls_id": "IL_MRED",
                "photos": [
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969.JPG",
                        "ph_order": 1
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_1.JPG",
                        "ph_order": 2
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_2.JPG",
                        "ph_order": 3
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_3.JPG",
                        "ph_order": 4
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_4.JPG",
                        "ph_order": 5
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_5.JPG",
                        "ph_order": 6
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_6.JPG",
                        "ph_order": 7
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_7.JPG",
                        "ph_order": 8
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_8.JPG",
                        "ph_order": 9
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_9.JPG",
                        "ph_order": 10
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_10.JPG",
                        "ph_order": 11
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_11.JPG",
                        "ph_order": 12
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_12.JPG",
                        "ph_order": 13
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_13.JPG",
                        "ph_order": 14
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_14.JPG",
                        "ph_order": 15
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_15.JPG",
                        "ph_order": 16
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_16.JPG",
                        "ph_order": 17
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_17.JPG",
                        "ph_order": 18
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_18.JPG",
                        "ph_order": 19
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_19.JPG",
                        "ph_order": 20
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_20.JPG",
                        "ph_order": 21
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_21.JPG",
                        "ph_order": 22
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_22.JPG",
                        "ph_order": 23
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_23.JPG",
                        "ph_order": 24
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_24.JPG",
                        "ph_order": 25
                    },
                    {
                        "ph_url": "http://photos.mredllc.com/photos/property/969/10164969_25.JPG",
                        "ph_order": 26
                    }
                ],
                "list_dt": "2019-01-04T00:00:00Z",
                "version": "1.0.0",
                "kw_agent": false,
                "list_key": "IL_MRED-10164969",
                "location": {
                    "county": "Kane",
                    "subdivision": "Whitmore Place",
                    "prop_directions": "Rt 25 (N of Army Trail) to Carl Lee Rd W to Whitmore"
                },
                "mls_name": "Midwest Real Estate Data",
                "brokerage": {
                    "name": "RE/MAX Excels"
                },
                "full_bath": 3,
                "half_bath": 1,
                "list_desc": "Stunning townhome in sought after Whitmore Place.  Open and inviting with wood floors and a fire place.  This 3 bedroom 3 full and 1 half bath home is a delight to see.  The first floor has a kitchen, dining area, living room, and half bath.  The eat in kitchen has 42\" maple cabinets, Corian countertops and tile floor.  The eating area has a sliding glass door that opens to a patio and park like setting.  The second floor boasts a master bedroom suite with vaulted ceiling, double bowl vanity sep shower & soaking tub. There are 2 additional spacious bedrooms and full hall bath.  The convenient laundry is also located on the second floor.  The basement has been professionally finished with rec room and full bath.  This is a must see!  Can lighting, drywall, and beautiful trim complete this package.  There is also plenty of storage. This is the one you have been waiting for. See it soon. Nothing to do but move in!",
                "list_type": "MLS Listing",
                "list_uuid": "211aa267-c8b9-4046-a9e1-e2fd949a3e0a",
                "prop_type": "Residential",
                "structure": {
                    "floorings": [
                        "Living Room: Hardwood"
                    ],
                    "utilities": [
                        "Public"
                    ],
                    "appliances": [
                        "Oven/Range",
                        "Microwave",
                        "Dishwasher",
                        "Refrigerator",
                        "Washer",
                        "Dryer",
                        "Disposal",
                        "Water Softener Owned"
                    ],
                    "has_garage": true,
                    "roof_types": [
                        "Asphalt/Glass (Shingles)"
                    ],
                    "has_parking": true,
                    "basement_desc": "Full,Bathrooms: No,Finished",
                    "parking_total": 2,
                    "fireplace_desc": "Gas Logs,Living Room",
                    "heating_cooling": [
                        "Central Air",
                        "Fuel: Gas",
                        "Fuel: Forced Air"
                    ],
                    "fireplaces_total": 1,
                    "parking_features": [
                        "Type: Attached",
                        "Number of Cars: 2",
                        "Garage"
                    ],
                    "exterior_features": {
                        "has_deck": false,
                        "has_dock": false,
                        "has_pond": false,
                        "has_pool": false,
                        "has_patio": false,
                        "has_porch": false,
                        "has_garden": false,
                        "has_rv_parking": false,
                        "is_water_front": true,
                        "has_gated_entry": false,
                        "has_green_house": false,
                        "has_hot_tub_spa": false,
                        "has_sports_court": false,
                        "has_barbecue_area": false,
                        "has_disabled_access": true,
                        "has_sprinkler_system": false
                    },
                    "interior_features": {
                        "is_wired": false,
                        "has_sauna": false,
                        "has_wet_bar": false,
                        "has_skylight": false,
                        "has_fireplace": true,
                        "is_cable_ready": false,
                        "has_ceiling_fan": false,
                        "has_mother_in_law": false,
                        "has_jetted_bath_tub": false,
                        "has_security_system": false,
                        "has_vaulted_ceiling": false
                    },
                    "foundation_details": [
                        "Concrete"
                    ],
                    "is_new_construction": true
                },
                "syndicate": [
                    "KW My MC",
                    "KW My Country",
                    "KW All",
                    "KW Consumer",
                    "KW Global"
                ],
                "total_bed": 3,
                "is_deleted": false,
                "kw_listing": false,
                "mls_number": "10164969",
                "total_bath": 3,
                "year_built": "2005",
                "kwls_status": "Accepted",
                "list_status": "Active",
                "living_area": 1881,
                "luxury_home": false,
                "photos_lock": false,
                "kw_expiry_dt": "2019-04-08",
                "list_address": {
                    "city": "St. Charles",
                    "zip_4": "5606",
                    "state_prov": "IL",
                    "postal_code": "60174",
                    "street_name": "Whitmore",
                    "unit_number": "B",
                    "street_number": "6N325",
                    "street_suffix": "Cir",
                    "coordinates_gp": {
                        "lat": 41.961391,
                        "lon": -88.292978
                    },
                    "coordinates_gs": {
                        "type": "Point",
                        "coordinates": [
                            -88.292978,
                            41.961391
                        ]
                    },
                    "full_street_address": "6N325 Whitmore Circle"
                },
                "manual_entry": false,
                "prop_subtype": "Condominium",
                "prop_type_id": 2,
                "currency_code": "USD",
                "kw_updated_at": "2019-04-04T06:03:06.772Z",
                "kw_updated_by": "Smarter Agent",
                "list_category": "For Sale",
                "mls_source_id": 200,
                "list_desc_lock": false,
                "list_status_id": 1,
                "marketing_info": {
                    "vow": false,
                    "display_photo": true,
                    "courtesy_label": "Courtesy of",
                    "display_address": true,
                    "display_internet": true,
                    "courtesy_location": "BOTTOM",
                    "display_list_price": true,
                    "photo_courtesy_required": false
                },
                "mls_updated_at": "2019-01-10T06:05:24.000Z",
                "prop_type_lock": false,
                "prop_subtype_id": 2,
                "list_category_id": 2,
                "list_status_lock": false,
                "one_quarter_bath": 0,
                "property_address": {
                    "zip_4": "5673",
                    "city_long": "Saint Charles",
                    "unit_type": "Unit",
                    "city_short": "St Charles",
                    "street_long": "Whitmore",
                    "unit_number": "B",
                    "street_number": "6N325",
                    "coordinates_gp": {
                        "lat": 41.94324,
                        "lon": -88.29865
                    },
                    "coordinates_gs": {
                        "type": "Point",
                        "coordinates": [
                            -88.29865,
                            41.94324
                        ]
                    },
                    "postal_code_long": "60174-5673",
                    "state_prov_short": "IL",
                    "postal_code_short": "60174",
                    "full_street_address": "6N325 Whitmore Cir Unit B",
                    "street_suffix_short": "Cir"
                },
                "kw_expiry_dt_lock": false,
                "list_agent_office": {
                    "list_agent_key": "IL_MRED-30-783",
                    "list_office_key": "IL_MRED-30",
                    "list_agent_email": "pam.raverteam@gmail.com",
                    "list_office_name": "RE/MAX Excels",
                    "list_agent_mls_id": "783",
                    "list_office_email": "chrishansen@remax.net",
                    "list_office_phone": "(630) 208-7400",
                    "list_office_mls_id": "30",
                    "list_agent_full_name": "Pamela Raver",
                    "list_agent_preferred_phone": "6305133189"
                },
                "living_area_units": "SF",
                "prop_subtype_lock": false,
                "current_list_price": 265000,
                "source_system_name": "Smarter Agent",
                "three_quarter_bath": 0,
                "days_on_market": 186
            }
        }
    ]
}
```


## Current Data from  Bounding Box
```json=
{
    "meta": {
        "total": 1671,
        "count": 1
    },
    "data": [
        {
            "id": "32034",
            "type": "area",
            "attributes": {
                "city": "Austin",
                "type_id": "neighborhood",
                "country": "US",
                "location": {
                    "type": "MultiPolygon",
                    "coordinates": [
                        [
                            [
                                [
                                    -97.777205,
                                    30.425327
                                ],
                                [
                                    -97.777201,
                                    30.425407
                                ],
                                [
                                    -97.777392,
                                    30.425903
                                ],
                                [
                                    -97.77696,
                                    30.426128
                                ],
                                [
                                    -97.77649,
                                    30.426228
                                ],
                                [
                                    -97.775569,
                                    30.426281
                                ],
                                [
                                    -97.776161,
                                    30.42775
                                ],
                                [
                                    -97.776238,
                                    30.428261
                                ],
                                [
                                    -97.776016,
                                    30.428308
                                ],
                                [
                                    -97.77571,
                                    30.428287
                                ],
                                [
                                    -97.775596,
                                    30.428369
                                ],
                                [
                                    -97.775173,
                                    30.428281
                                ],
                                [
                                    -97.775138,
                                    30.428427
                                ],
                                [
                                    -97.774939,
                                    30.428699
                                ],
                                [
                                    -97.774664,
                                    30.428869
                                ],
                                [
                                    -97.773482,
                                    30.429255
                                ],
                                [
                                    -97.773322,
                                    30.429447
                                ],
                                [
                                    -97.773295,
                                    30.429423
                                ],
                                [
                                    -97.773011,
                                    30.429659
                                ],
                                [
                                    -97.773253,
                                    30.42994
                                ],
                                [
                                    -97.772364,
                                    30.430739
                                ],
                                [
                                    -97.772098,
                                    30.430886
                                ],
                                [
                                    -97.770339,
                                    30.431625
                                ],
                                [
                                    -97.769789,
                                    30.43203
                                ],
                                [
                                    -97.76908,
                                    30.432634
                                ],
                                [
                                    -97.768606,
                                    30.433147
                                ],
                                [
                                    -97.767867,
                                    30.432473
                                ],
                                [
                                    -97.762359,
                                    30.428855
                                ],
                                [
                                    -97.761421,
                                    30.428256
                                ],
                                [
                                    -97.759181,
                                    30.427164
                                ],
                                [
                                    -97.758862,
                                    30.426923
                                ],
                                [
                                    -97.760677,
                                    30.424105
                                ],
                                [
                                    -97.757512,
                                    30.422571
                                ],
                                [
                                    -97.7592585423278,
                                    30.4198674887081
                                ],
                                [
                                    -97.762418,
                                    30.421314
                                ],
                                [
                                    -97.762995,
                                    30.420389
                                ],
                                [
                                    -97.763635,
                                    30.419397
                                ],
                                [
                                    -97.76504,
                                    30.417213
                                ],
                                [
                                    -97.765347,
                                    30.416719
                                ],
                                [
                                    -97.766892,
                                    30.417486
                                ],
                                [
                                    -97.766635,
                                    30.417902
                                ],
                                [
                                    -97.766674,
                                    30.418044
                                ],
                                [
                                    -97.768217,
                                    30.418778
                                ],
                                [
                                    -97.772725,
                                    30.420953
                                ],
                                [
                                    -97.772964,
                                    30.420672
                                ],
                                [
                                    -97.773367,
                                    30.421054
                                ],
                                [
                                    -97.7737,
                                    30.421202
                                ],
                                [
                                    -97.774269,
                                    30.421259
                                ],
                                [
                                    -97.774697,
                                    30.421009
                                ],
                                [
                                    -97.774846,
                                    30.421005
                                ],
                                [
                                    -97.775028,
                                    30.420836
                                ],
                                [
                                    -97.775189,
                                    30.420631
                                ],
                                [
                                    -97.776013,
                                    30.42016
                                ],
                                [
                                    -97.77645,
                                    30.420637
                                ],
                                [
                                    -97.777311,
                                    30.421181
                                ],
                                [
                                    -97.777575,
                                    30.421437
                                ],
                                [
                                    -97.777921,
                                    30.422637
                                ],
                                [
                                    -97.777359,
                                    30.423399
                                ],
                                [
                                    -97.77726,
                                    30.423747
                                ],
                                [
                                    -97.777387,
                                    30.424288
                                ],
                                [
                                    -97.777832,
                                    30.424771
                                ],
                                [
                                    -97.777205,
                                    30.425327
                                ]
                            ]
                        ]
                    ]
                },
                "centroid_gp": {
                    "lat": 30.425049,
                    "lon": -97.76879374716111
                },
                "area_meter_square": 1967771.82,
                "state_or_province": "TX",
                "neighborhood_name": "Oak Forest",
                "state_or_province_full": "Texas"
            }
        }
    ]
}
```


## Current Data Represantion In UI

### Agent Data (for the side drawer)

```javascript=
{
    "agent_id123": {
        dataId,
        fullName,
        isKwAgent,
        kwUid,
        mlsId,
        phone,
        email,
        officeName,
        brokerage,
        city,
        stateProv,
        listings[],
        neighborhoods[],
    }
}
```

### Listing Data

```javascript=
{
    "listingId12312": {
        coordinate: {
            lat,
            long,
        },
        agentId,
        neighborhoodId,
        listingId,
        dataId,
        isKwMc,
        isKwListing,
        marketCenter,
    }
}
```

### Neighborhood Data

```javascript=
{
    "neighborhoodId123": {
        coordinates: Polygon[],
        id,
        city,
        locationType,
        neighborhoodName,
    }
}
```

### Spec
the bounding box and the listing editor api have the same parameter for example
> listing editor: `/listing-editor?top_left[lat]=${NeLat}&top_left[lon]=${SwLng}&bottom_right[lat]=${SwLat}&bottom_right[lon]=${NeLng}&page[limit]=${limit}`
> 
> bounding box: `/bounding_box?top_left[lat]=${NeLat}&top_left[lon]=${SwLng}&bottom_right[lat]=${SwLat}&bottom_right[lon]=${NeLng}&filter[boundary_type]=neighborhood&page[limit]=50`
> 

so we can combine them in one proxy url ?
ex
`/market-share-service?top_left[lat]=${NeLat}&top_left[lon]=${SwLng}&bottom_right[lat]=${SwLat}&bottom_right[lon]=${NeLng}&filter[boundary_type]=neighborhood&page[limit]=50`

and just forward those paramater.
the response of the service could be something like this.
for the concise
```json=
{
    "data": {
        "neighborhoods": [
            {
                coordinates: Polygon[],
                id: "123131",
                city: "New York City",
                locationType: "MultiPolygon",
                neighborhoodName: "Haboken",
            }
        ],
        "listings": [
            {
                coordinate: {
                    lat: 81.3113,
                    long: 38.3131,
                },
                agentId: "agent_mls_id",
                neighborhoodId: "neighborhoodId or null",
                listingId: "list_key",
                isKwMc: true,
                isKwListing: true,
                marketCenter: 21,
            }
        ],
        "agents": [
            {
                isKwAgent: false,
                kwUid: "1312313 or null",
                mlsId: "mls_agent_id",
                brokerage: "KW Brokerage",
                city: "New York City",
                listings: ["listingId1", "listingId2"],
                neighborhoods: ["NeighborhoodId1", "NeighborhoodId2"],
                phone: "+12312312312",
                email: "asddasd@gmail.com",
                officeName: "Lander Office",
            }
        ]
    }
}
```

## How to Tie Listing Data and Neighborhood Data

We can use a geolib/geofencing library to determine if Listings coordinate is inside the neighborhood polygon for example in php using this library
https://github.com/mjaschen/phpgeo

The lib also have simplify polyline for simplifying neighborhood coordinates https://github.com/mjaschen/phpgeo#simplifying-a-polyline


## Rec