Mapping Products to Vehicles

1. Fetching Vehicle Data

Definitions:

OE replacements – products matching original, factory specifications
Staggered width – vehicles with smaller width wheels/tires on the front axle and larger on the rear axle(s).
Staggered diameter – same as above but for diameter

The initial step is to retrieve vehicle fitment data, which includes fitments and tags, using the following URL parameters:

i-fitments - Original Equipment (OE) fitments
i-optionalFitments - Optional Original Equipment fitments
i-plusSizes - Other possible wheel and tire configurations; some may require vehicle modifications (use fitment notes)
i-tags - Vehicle segment tags and niche tags

The user can be presented with fitments, optional fitments, and plus sizes to facilitate the selection of their vehicle configuration. Compatible products (tires and/or wheels) can be queried for once a fitment is selected.

	Application	Fitments

	Application	Fitments
1	OE replacements	Use values from `Fitments` and `OptionalFitments`
2	Compatible products not requiring modifications	Add `PlusSizes` without notes
3	Minor modifications	Add `PlusSizes` with notes and warn customers when fitments with notes are selected
4	Modified Suspension	Allow any diameters, widths and offsets

StaggeredWidth and StaggeredDiameter values may be used to offer different front and rear sizes even when not listed in vehicle’s fitments. This is optional and based on aftermarket trends.

Plus sizes are compatible only within each ChassisId. When the user selects an OE fitment, they may be presented with a list of plus sizes that match the ChassisId of the OE fitment.

DefaultChassisId points to the estimated most likely configuration for the vehicle.

Example

https://api.autosyncstudio.com/vehicles?f-id=297109&i-fitments&i-plusSizes&i-optionalFitments&i-tags&key=YOUR_KEY

f-id: 297109
i-fitments: 
i-plusSizes: 
i-optionalFitments: 
i-tags: 
key: YOUR_KEY

The above query will return the following values (irrelevant fields were omitted):

"BoltCircle": 114.3,
"Bore": 70.6,
"BoreRear": null,
"DefaultChassisId": 92515,
"Drw": false,
"LoadRating": 97,
"LoadRatingRear": null,
"LugCount": 5,
"MaxWheelLoad": 560,
"NicheTag": "Mustang",
"StaggeredDiameter": false,
"StaggeredWidth": true,
"Tags": ["Classic", "Luxury", "Replica"]
"Type": "Car",
"Fitments": [{
    "AspectRatio": 50,
    "AspectRatioRear": null,
    "ChassisId": 92515,
    "Diameter": null,
    "DiameterRear": null,
    "Format": "M",
    "Id": 174681,
    "InchWidth": null,
    "InchWidthRear": null,
    "MaxOffset": 45,
    "MaxOffsetRear": null,
    "MinOffset": 30,
    "MinOffsetRear": null,
    "Name": "",
    "Offset": 40,
    "OffsetRear": null,
    "RimDiameter": 18,
    "RimDiameterRear": null,
    "RimWidth": 8,
    "RimWidthRear": null,
    "SectionWidth": 235,
    "SectionWidthRear": null,
    "SpeedRating": "W",
    "SpeedRatingRear": null,
    "TireSize": "235/50R18",
    "TireSizeRear": null
  },
  ...
],
"OptionalFitments": [{
    "AspectRatio": 40,
    "AspectRatioRear": 40,
    "ChassisId": 61654,
    "Diameter": null,
    "DiameterRear": null,
    "Format": "M",
    "Id": 174686,
    "InchWidth": null,
    "InchWidthRear": null,
    "MaxOffset": null,
    "MaxOffsetRear": 48,
    "MinOffset": null,
    "MinOffsetRear": 35,
    "Offset": 45,
    "OffsetRear": 52,
    "RimDiameter": 19,
    "RimDiameterRear": 19,
    "RimWidth": 9.5,
    "RimWidthRear": 10,
    "SectionWidth": 255,
    "SectionWidthRear": 275,
    "SpeedRating": "(Y)",
    "SpeedRatingRear": "(Y)",
    "TireSize": "255/40R19",
    "TireSizeRear": "275/40R19"
  }
],
"PlusSizes": [{
    "AspectRatio": 40,
    "ChassisId": 61654,
    "Diameter": null,
    "Format": "M",
    "InchWidth": null,
    "MaxOffset": 40,
    "MinOffset": 30,
    "Notes": [],
    "RimDiameter": 19,
    "RimWidth": 8.5,
    "SectionWidth": 245,
    "TireSize": "245/40R19",
    "Type": "F"
  },
  ... 
]

2. Wheels

Matching Wheel Styles

See the API Guide for a description of the parameters:
https://autosync.atlassian.net/wiki/spaces/ascwiki/pages/657227777

Vehicle	Wheel Styles	Notes

Vehicle	Wheel Styles	Notes
LugCount	`f-lugCount`
BoltCircle	`f-boltCircle`
Bore and BoreRear	`f-minBore`	If BoreRear is not `NULL` use the bigger of the two: Bore, BoreRear.
MaxWheelLoad	`f-minLoadRating`
Type or Drw	`f-andVehicleTypeTags`	If Drw (Dual Rear Wheels) is set to `true` the value of the filter should be set to “Dually”, otherwise it should be set to the value of Type. `f-orVehicleTypeTags` or `f-andVehicleTypeTags` filter may be used; in this context, it wouldn't make a difference.
Tags	`f-orSegmentTags`	Comma-separated values
NicheTag	`f-nicheTag`
Offset	`f-offset`	Taken from OE fitments. Use this value for factory replacements. Otherwise, see MinOffset and MaxOffset below.
MinOffset and MaxOffset	`f-minOffset` and `f-maxOffset`	These are taken from plus sizes. The values may be applied to OE fitments if `ChassisId` and wheel size match.
RimDiameter and RimDiameterRear	`f-diameters`	If RimDiameterRear is not `NULL` set `f-diameters` to RimDiameter and `f-diameters2` to RimDiameterRear.
RimWidth and RimWidthRear	`f-widths`	If RimWidthRear is not `NULL` set `f-widths` to RimWidth and `f-widths2` to RimWidthRear.

Pseudocode for Matching Wheel Styles

Pascal-case labels represent vehicle related fields. Snake-case labels represent wheel related fields.

LugCount = lug_count AND
(BoltCircle = bolt_circle1 OR BoltCircle = bolt_circle2) AND
MAX(Bore, BoreRear) <= bore  AND
MaxWheelLoad <= load_rating  AND
if Drw = true {
  "Dually" IN wheel_tags
} else {
  Type IN wheel_tags
} AND
at least one of the Tags IN wheel_tags AND
(NicheTag = niche_tag OR niche_tag IS NULL) AND
MinOffset <= offset AND MaxOffset >= offset AND
RimDiameter = diameter  AND
RimWidth = width

If any of the rear values are not NULL, analogues code would be required for matching rear tires.

For OE replacements replace line 12 with:

Example

https://api.autosyncstudio.com/wheels/styles?f-diameters=18&f-widths=8&f-orSegmentTags=Classic,Luxury,Replica&f-orVehicleTypeTags=Car&f-lugCount=5&f-boltCircle=114.3&f-minBore=70.6&f-minLoadRating=560&f-nicheTag=Mustang&f-minOffset=30&f-maxOffset=45&key=YOUR_KEY

For OE replacements replace lines 10 and 11 with:

3. Tires

Matching Tire Models

See the API Guide for a description of the parameters:
https://autosync.atlassian.net/wiki/spaces/ascwiki/pages/657227777

METRIC - fields relevant to metric tires only (Format = M)

FLOTATION - fields relevant to flotation tires only (Format = F)

Vehicle	Tire Models	Notes

Vehicle	Tire Models	Notes
Type	`f-orVehicleTypeTags`	See Note 3 below for details on converting vehicle type to tire tags. `f-orVehicleTypeTags` or `f-andVehicleTypeTags` filter may be used; in this context, it wouldn't make a difference.
SpeedRating and SpeedRatingRear	`f-minSpeedRating`	If SpeedRatingRear is not `NULL` use the higher of the two: SpeedRating, SpeedRatingRear.
LoadRating and LoadRatingRear	`f-minLoadRating`	If LoadRatingRear is not `NULL` set `f-minLoadRating` to LoadRating and `f-minLoadRating2` to LoadRatingRear.
SectionWidth and SectionWidthRear	`f-sectionWidth`	METRIC If SectionWidthRear is not `NULL` set `f-sectionWidth` to SectionWidth and `f-sectionWidth2` to SectionWidthRear.
AspectRatio and AspectRatioRear	`f-aspectRatio`	METRIC If AspectRatioRear is not `NULL` set `f-aspectRatio` to AspectRatio and `f-aspectRatio2` to AspectRatioRear.
RimDiameter and RimDiameterRear	`f-rimDiameter`	METRIC / FLOTATION If RimDiameterRear is not `NULL` set `f-rimDiameter` to RimDiameter and `f-rimDiameter2` to RimDiameterRear.
Diameter and DiameterRear	`f-diameter`	FLOTATION If DiameterRear is not `NULL` set `f-diameter` to Diameter and `f-diameter2` to DiameterRear.
InchWidth and InchWidthRear	`f-inchWidth`	FLOTATION If InchWidthRear is not `NULL` set `f-inchWidth` to InchWidth and `f-inchWidth2` to InchWidthRear.

Pseudocode for Matching Tire Models

Pascal-case labels represent vehicle related fields. Snake-case labels represent tire related fields.

Note 1. If any of the rear values are not NULL, analogues code would be required for matching rear tires.

Note 2. Speed ratings ordered from the lowest to the highest:

Note 3. Vehicle type to tire tag conversion:

Car → Car/CUV

CUV → Car/CUV

SUV → UV/Light Truck

Truck → UV/Light Truck

Van → UV/Light Truck

UTV → ATV/UTV

Example

https://api.autosyncstudio.com/tires/models?f-andVehicleTypeTags=Car%2FCUV&f-aspectRatio=50&f-minLoadRating=97&f-minSpeedRating=W&f-rimDiameter=18&f-sectionWidth=235&key=YOUR_KEY