mapricot 0.11.0 → 0.12.0

package/README.md

@@ -30,6 +30,7 @@ Methods are grouped by product, the same way as the API's paths. Each returns th
 | Method | Endpoint |
 | --- | --- |
 | `client.geocoding.search(q, { focus, country, limit, lang })` | [`GET /geocoding/v1/search`](https://mapricot.com/docs/geocoding/#find-an-address) |
+| `client.geocoding.searchBatch(queries)` | [`POST /geocoding/v1/search/batch`](https://mapricot.com/docs/geocoding/#search-a-list-of-addresses) |
 | `client.geocoding.autocomplete(q, { focus, country, limit, lang })` | [`GET /geocoding/v1/autocomplete`](https://mapricot.com/docs/geocoding/#suggest-as-people-type) |
 | `client.geocoding.reverse(lat, lon, { limit, lang })` | [`GET /geocoding/v1/reverse`](https://mapricot.com/docs/geocoding/#find-the-address-at-a-point) |
 | `client.places.nearby(lat, lon, { category, radius, limit, lang })` | [`GET /places/v1/nearby`](https://mapricot.com/docs/places/#list-places-around-a-point) |
@@ -48,6 +49,13 @@ const { routes } = await client.routing.route([{ lat: 45.5189, lon: -122.6793 },
 console.log(routes[0].durationSeconds);
 ```
 
+`searchBatch` runs up to 100 searches in one request. Each query is an object of `search`'s parameters, and `responses` answers them in the same order, each with `results` and `attribution`, or an `error` with the `code` and `message` that search would get, without rejecting. Each completed search is billed as one request; errors aren't.
+
+```js
+const { responses } = await client.geocoding.searchBatch([{ q: "128 SW 3rd Ave, Portland", limit: 1 }, { q: "10 Downing Street, London", limit: 1 }]);
+for (const response of responses) console.log(response.error?.message ?? response.results[0].label);
+```
+
 To cancel a request, such as an autocomplete request for text that has since changed, pass an `AbortSignal` as `signal` to any method. The request then rejects with an `AbortError`:
 
 ```js

package/dist/index.d.ts

@@ -35,6 +35,27 @@ export interface Places {
     results: Place[];
     attribution: Attribution[];
 }
+/** One search in a batch, with the same parameters as `geocoding.search`. */
+export interface SearchQuery {
+    q: string;
+    focus?: Point;
+    country?: string | string[];
+    limit?: number;
+    lang?: string;
+}
+/** One search's answer in a batch: results and attribution, or the error the search would get on its own, unbilled. */
+export interface SearchResponse {
+    results?: Place[];
+    attribution?: Attribution[];
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface SearchBatch {
+    /** One per query, in the queries' order. */
+    responses: SearchResponse[];
+}
 export interface PlaceResult {
     result: Place;
     attribution: Attribution[];
@@ -159,6 +180,8 @@ export declare class Mapricot {
     readonly geocoding: {
         /** Find addresses and places matching free text. */
         search: (q: string, { signal, ...options }?: SearchOptions) => Promise<Places>;
+        /** Run up to 100 searches in one request. Each completed search is billed as one request. */
+        searchBatch: (queries: SearchQuery[], { signal }?: RequestOptions) => Promise<SearchBatch>;
         /** Suggest addresses and places as someone types. */
         autocomplete: (q: string, { signal, ...options }?: SearchOptions) => Promise<Places>;
         /** Find the address nearest a coordinate, or the area around it. */

package/dist/index.js

@@ -30,6 +30,10 @@ export class Mapricot {
         this.geocoding = {
             /** Find addresses and places matching free text. */
             search: (q, { signal, ...options } = {}) => __classPrivateFieldGet(this, _Mapricot_instances, "m", _Mapricot_request).call(this, "GET", "/geocoding/v1/search", { q, ...options }, signal),
+            /** Run up to 100 searches in one request. Each completed search is billed as one request. */
+            searchBatch: (queries, { signal } = {}) => __classPrivateFieldGet(this, _Mapricot_instances, "m", _Mapricot_request).call(this, "POST", "/geocoding/v1/search/batch", {}, signal, {
+                queries: queries.map((query) => Object.fromEntries(Object.entries(query).map(([name, value]) => [name, format(value)]))),
+            }),
             /** Suggest addresses and places as someone types. */
             autocomplete: (q, { signal, ...options } = {}) => __classPrivateFieldGet(this, _Mapricot_instances, "m", _Mapricot_request).call(this, "GET", "/geocoding/v1/autocomplete", { q, ...options }, signal),
             /** Find the address nearest a coordinate, or the area around it. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mapricot",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Official client for the Mapricot API: geocoding, places, routing, and IP geolocation.",
   "keywords": [
     "geocoding",