apple-maps-server-sdk - npm Package Compare versions

Comparing version 1.0.9 to 1.1.0

lib/globals.d.ts

@@ -53,3 +53,3 @@ type PoiCategory = "Airport" | "AirportGate" | "AirportTerminal" | "AmusementPark" | "ATM" | "Aquarium" | "Bakery" | "Bank" | "Beach" | "Brewery" | "Cafe" | "Campground" | "CarRental" | "EVCharger" | "FireStation" | "FitnessCenter" | "FoodMarket" | "GasStation" | "Hospital" | "Hotel" | "Laundry" | "Library" | "Marina" | "MovieTheater" | "Museum" | "NationalPark" | "Nightlife" | "Park" | "Parking" | "Pharmacy" | "Playground" | "Police" | "PostOffice" | "PublicTransport" | "ReligiousSite" | "Restaurant" | "Restroom" | "School" | "Stadium" | "Store" | "Theater" | "University" | "Winery" | "Zoo";
 export interface ReverseGeocodeInput {
-    q: string;
+    loc: string;
     lang?: string;
@@ -56,0 +56,0 @@ }

package.json

 {
   "name": "apple-maps-server-sdk",
-  "version": "1.0.9",
+  "version": "1.1.0",
   "description": "An SDK for the Apple Maps Server API",
@@ -5,0 +5,0 @@ "main": "lib/index.js",

README.md

@@ -209,2 +209,200 @@
 
+## API
 
+#### .geocode(options [object])
+
+Fetch geocoded data about an address.
+
+**options**: supports keys
+- `q` \[required\] - The address to geocode. IE: 1 Apple Park, Cupertino, CA
+- `limitToCountries` \[optional\] - A comma-separated list of country codes to limit the results to IE: US,CA.
+- `lang` \[optional\] - The language the server should use when returning the response, specified using a BCP 47 language code. IE: en-US.
+- `searchLocation` \[optional\] - A location defined as a hint. Specify the location as a comma-separated string containing the latitude and longitude. IE: 37.78,-122.42.
+- `searchRegion` \[optional\] - A region defined as a hint. Specify the region specified as a comma-separated string that describes the region in the form north-latitude, east-longitude, south-latitude, west-longitude. IE: 38,-122.1,37.5,-122.5.
+- `userLocation` \[optional\] - The location of the user, specified as a comma-separated string that contains the latitude and longitude. IE: 37.78,-122.42.
+
+**response**
+```
+{
+  "results": [
+    {
+      country: string;
+      countryCode: string;
+      displayMapRegion: {
+        eastLongitude: number;
+        northLatitude: number;
+        southLatitude: number;
+        westLongitude: number;
+      };
+      formattedAddressLines: string[];
+      name: string;
+      coordinate: {
+        latitude: number;
+        longitude: number;
+      };
+      structuredAddress: {
+        administrativeArea: string;
+        administrativeAreaCode: string;
+        areasOfInterest: string[];
+        dependentLocalities: string[];
+        fullThoroughfare: string;
+        locality: string;
+        postCode: string;
+        subLocality: string;
+        subThoroughfare: string;
+        thoroughfare: string;
+      }
+    }
+  ]
+}
+```
+
+#### .reverseGeocode(options [object])
+
+Fetch reverse geocoded data about coordinates.
+
+**options**: supports keys
+- `loc` \[required\] - The coordinate to reverse geocode as a comma-separated string that contains the latitude and longitude. IE: 37.3316851,-122.0300674.
+- `lang` \[optional\] - The language the server should use when returning the response, specified using a BCP 47 language code. IE: en-US.
+
+**response**
+```
+{
+  "results": [
+    {
+      country: string;
+      countryCode: string;
+      displayMapRegion: {
+        eastLongitude: number;
+        northLatitude: number;
+        southLatitude: number;
+        westLongitude: number;
+      };
+      formattedAddressLines: string[];
+      name: string;
+      coordinate: {
+        latitude: number;
+        longitude: number;
+      };
+      structuredAddress: {
+        administrativeArea: string;
+        administrativeAreaCode: string;
+        areasOfInterest: string[];
+        dependentLocalities: string[];
+        fullThoroughfare: string;
+        locality: string;
+        postCode: string;
+        subLocality: string;
+        subThoroughfare: string;
+        thoroughfare: string;
+      }
+    }
+  ]
+}
+```
+
+#### .eta(options [object])
+
+Returns the estimated time of arrival (ETA) and distance between starting and ending locations.
+
+**options**: supports keys
+- `origin` \[required\] - The starting point for estimated arrival time requests, specified as a comma-separated string that contains the latitude and longitude. IE: 37.331423,-122.030503.
+- `destinations` \[required\] - Destination coordinates represented as pairs of latitude and longitude separated by a vertical bar character (”|”).
+IE: 37.32556561130194,-121.94635203581443|37.44176585512703,-122.17259315798667.
+
+The parameter must specify at least one destination coordinate, but no more than 10 destinations. Specify the location as a comma-separated string that contains the latitude and longitude.
+- `transportType` \[optional\] - The mode of transportation to use when estimating arrival times.
+
+Default: Automobile
+
+Possible values: Automobile, Transit, Walking
+- `departureDate` \[optional\] - The time of departure to use in an estimated arrival time request, in ISO 8601 format in UTC time.
+IE: 2020-09-15T16:42:00Z.
+
+If you don’t specify a departure date, the server uses the current date and time when you make the request.
+- `arrivalDate` \[optional\] - The intended time of arrival in ISO 8601 format in UTC time.
+
+**response**
+```
+{
+  "etas": [
+    {
+      destination: {
+        latitude: number;
+        longitude: number;
+      };
+      distanceMeters: number;
+      expectedTravelTimeSeconds: number;
+      staticTravelTimeSeconds: number;
+      transportType: "Automobile" | "Transit" | "Walking";
+    }
+  ]
+}
+```
+
+
+#### .search(options [object])
+
+Find places by name or by specific search criteria.
+
+**options**: supports keys
+- `q` \[required\] - The place to search for. IE: eiffel tower.
+- `excludePoiCategories` \[optional\] - A comma-separated list of strings that describes the points of interest to exclude from the search results. IE: Restaurant,Cafe. See [https://developer.apple.com/documentation/applemapsserverapi/poicategory](https://developer.apple.com/documentation/applemapsserverapi/poicategory) for a list of all possible PoiCategories. 
+- `includePoiCategories` \[optional\] - A comma-separated list of strings that describes the points of interest to include in the search results. IE: Restaurant,Cafe. See [https://developer.apple.com/documentation/applemapsserverapi/poicategory](https://developer.apple.com/documentation/applemapsserverapi/poicategory) for a list of all possible PoiCategories. 
+- `limitToCountries` \[optional\] - A comma-separated list of ISO ALPHA-2 codes of the countries to limit the results to. IE: US,CA limits the search to the United States and Canada.
+- `resultTypeFilter` \[optional\] - A comma-separated list of strings that describes the kind of result types to include in the response. IE: Poi.
+
+Possible values: Poi, Address
+- `lang` \[optional\] - The language the server should use when returning the response. IE: en-US. Defaults to en-US.
+- `searchLocation` \[optional\] - A location defined as a hint. Specify the location as a comma-separated string containing the latitude and longitude. IE: 37.78,-122.42.
+- `searchRegion` \[optional\] - A region defined as a hint. Specify the region specified as a comma-separated string that describes the region in the form north-latitude,east-longitude,south-latitude,west-longitude. IE: 38,-122.1,37.5,-122.5.
+- `userLocation` \[optional\] - The location of the user, specified as a comma-separated string that contains the latitude and longitude. IE: 37.78,-122.42.
+
+**response**
+```
+{
+  "displayMapRegion": {
+    eastLongitude: number;
+    northLatitude: number;
+    southLatitude: number;
+    westLongitude: number;
+  }
+  "results": [
+    {
+      poiCategory: PoiCategory;
+      country: string;
+      countryCode: string;
+      displayMapRegion: {
+        eastLongitude: number;
+        northLatitude: number;
+        southLatitude: number;
+        westLongitude: number;
+      };
+      formattedAddressLines: string[];
+      name: string;
+      coordinate: {
+        latitude: number;
+        longitude: number;
+      };
+      structuredAddress: {
+        administrativeArea: string;
+        administrativeAreaCode: string;
+        areasOfInterest: string[];
+        dependentLocalities: string[];
+        fullThoroughfare: string;
+        locality: string;
+        postCode: string;
+        subLocality: string;
+        subThoroughfare: string;
+        thoroughfare: string;
+      }
+    }
+  ]
+}
+```
+
+
+
+
+
+

src/globals.ts

@@ -107,3 +107,3 @@ // OBJECTS
 export interface ReverseGeocodeInput {
-  q: string;
+  loc: string;
   lang?: string;
@@ -110,0 +110,0 @@ }

New alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Fixed alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

33953

increased by29.13%

Number of lines in readme file

408

increased by94.29%

No dependency changes