# Map JSONs
Utilities to help load and parse json files related to {ref}`Map`.


- - -

## MapJSON.GetFile
```pascal
function MapJSON.GetFile(cachedir: String; chunk: TPoint; plane: Integer): TJSONArray;
```
Internal function to return a `JSONArray` of objects or npcs associated with the
specified `chunk` and `plane`.


- - -

## MapJSON.Load
```pascal
procedure TMapJSON.Load(regions: array of TRSMapRegion = []);
```
Internal method to load all objects or npcs JSON data associated with the
specified `regions` merged into a single `TJSONArray`.


- - -

## MapJSON.GetByName
```pascal
function TMapJSON.GetByName(name: String; amount: Integer = 0): TJSONArray;
```
Returns a `TJSONArray` of `JSONObjects` of a map object or npc that matches the
specified `name`.

By default you get all entries that match the `name`, however, if you want you
can specify how many unique IDs you want through `amount`.


- - -

## MapJSON.GetByID
```pascal
function TMapJSON.GetByID(id: Integer): TJSONObject;
```
Returns a `TJSONObject` of a map object that matches the specified `id`.


- - -

## MapJSON.GetByAction
```pascal
function TMapJSON.GetByAction(action: String; amount: Integer = 0): TJSONArray;
```
Returns a `TJSONArray` of `JSONObjects` of a map object or npc that has an
action that matches the specified `action`.

By default you get all entries that match the `action`, however, if you want
you can specify how many unique IDs you want through `amount`.