@azure-rest/maps-search 2.0.0-beta.2 → 2.0.0-beta.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +4 -4
- package/README.md +80 -90
- package/dist/browser/MapsSearch.d.ts +53 -0
- package/dist/browser/MapsSearch.d.ts.map +1 -0
- package/{dist-esm/src → dist/browser}/MapsSearch.js +1 -1
- package/dist/browser/MapsSearch.js.map +1 -0
- package/dist/browser/generated/clientDefinitions.d.ts +137 -0
- package/dist/browser/generated/clientDefinitions.d.ts.map +1 -0
- package/dist/browser/generated/clientDefinitions.js +4 -0
- package/dist/browser/generated/clientDefinitions.js.map +1 -0
- package/dist/browser/generated/index.d.ts +10 -0
- package/dist/browser/generated/index.d.ts.map +1 -0
- package/dist/browser/generated/index.js +12 -0
- package/dist/browser/generated/index.js.map +1 -0
- package/dist/browser/generated/isUnexpected.d.ts +7 -0
- package/dist/browser/generated/isUnexpected.d.ts.map +1 -0
- package/dist/browser/generated/isUnexpected.js +75 -0
- package/dist/browser/generated/isUnexpected.js.map +1 -0
- package/dist/browser/generated/logger.d.ts +2 -0
- package/dist/browser/generated/logger.d.ts.map +1 -0
- package/dist/browser/generated/logger.js.map +1 -0
- package/dist/browser/generated/mapsSearchClient.d.ts +15 -0
- package/dist/browser/generated/mapsSearchClient.d.ts.map +1 -0
- package/dist/browser/generated/mapsSearchClient.js +42 -0
- package/dist/browser/generated/mapsSearchClient.js.map +1 -0
- package/dist/browser/generated/models.d.ts +97 -0
- package/dist/browser/generated/models.d.ts.map +1 -0
- package/dist/browser/generated/models.js +4 -0
- package/dist/browser/generated/models.js.map +1 -0
- package/dist/browser/generated/outputModels.d.ts +298 -0
- package/dist/browser/generated/outputModels.d.ts.map +1 -0
- package/dist/browser/generated/outputModels.js +4 -0
- package/dist/browser/generated/outputModels.js.map +1 -0
- package/dist/browser/generated/parameters.d.ts +135 -0
- package/dist/browser/generated/parameters.d.ts.map +1 -0
- package/dist/browser/generated/parameters.js +4 -0
- package/dist/browser/generated/parameters.js.map +1 -0
- package/dist/browser/generated/responses.d.ts +255 -0
- package/dist/browser/generated/responses.d.ts.map +1 -0
- package/dist/browser/generated/responses.js +4 -0
- package/dist/browser/generated/responses.js.map +1 -0
- package/dist/browser/index.d.ts +4 -0
- package/dist/browser/index.d.ts.map +1 -0
- package/dist/browser/index.js +6 -0
- package/dist/browser/index.js.map +1 -0
- package/dist/browser/logger.d.ts +2 -0
- package/dist/browser/logger.d.ts.map +1 -0
- package/dist/browser/logger.js +5 -0
- package/dist/browser/package.json +3 -0
- package/dist/commonjs/MapsSearch.d.ts +53 -0
- package/dist/commonjs/MapsSearch.d.ts.map +1 -0
- package/dist/commonjs/MapsSearch.js +44 -0
- package/dist/commonjs/MapsSearch.js.map +1 -0
- package/dist/commonjs/generated/clientDefinitions.d.ts +137 -0
- package/dist/commonjs/generated/clientDefinitions.d.ts.map +1 -0
- package/dist/commonjs/generated/clientDefinitions.js +5 -0
- package/dist/commonjs/generated/clientDefinitions.js.map +1 -0
- package/dist/commonjs/generated/index.d.ts +10 -0
- package/dist/commonjs/generated/index.d.ts.map +1 -0
- package/dist/commonjs/generated/index.js +15 -0
- package/dist/commonjs/generated/index.js.map +1 -0
- package/dist/commonjs/generated/isUnexpected.d.ts +7 -0
- package/dist/commonjs/generated/isUnexpected.d.ts.map +1 -0
- package/dist/commonjs/generated/isUnexpected.js +78 -0
- package/dist/commonjs/generated/isUnexpected.js.map +1 -0
- package/dist/commonjs/generated/logger.d.ts +2 -0
- package/dist/commonjs/generated/logger.d.ts.map +1 -0
- package/dist/commonjs/generated/logger.js +8 -0
- package/dist/commonjs/generated/logger.js.map +1 -0
- package/dist/commonjs/generated/mapsSearchClient.d.ts +15 -0
- package/dist/commonjs/generated/mapsSearchClient.d.ts.map +1 -0
- package/dist/commonjs/generated/mapsSearchClient.js +45 -0
- package/dist/commonjs/generated/mapsSearchClient.js.map +1 -0
- package/dist/commonjs/generated/models.d.ts +97 -0
- package/dist/commonjs/generated/models.d.ts.map +1 -0
- package/dist/commonjs/generated/models.js +5 -0
- package/dist/commonjs/generated/models.js.map +1 -0
- package/dist/commonjs/generated/outputModels.d.ts +298 -0
- package/dist/commonjs/generated/outputModels.d.ts.map +1 -0
- package/dist/commonjs/generated/outputModels.js +5 -0
- package/dist/commonjs/generated/outputModels.js.map +1 -0
- package/dist/commonjs/generated/parameters.d.ts +135 -0
- package/dist/commonjs/generated/parameters.d.ts.map +1 -0
- package/dist/commonjs/generated/parameters.js +5 -0
- package/dist/commonjs/generated/parameters.js.map +1 -0
- package/dist/commonjs/generated/responses.d.ts +255 -0
- package/dist/commonjs/generated/responses.d.ts.map +1 -0
- package/dist/commonjs/generated/responses.js +5 -0
- package/dist/commonjs/generated/responses.js.map +1 -0
- package/dist/commonjs/index.d.ts +4 -0
- package/dist/commonjs/index.d.ts.map +1 -0
- package/dist/commonjs/index.js +9 -0
- package/dist/commonjs/index.js.map +1 -0
- package/dist/commonjs/logger.d.ts +2 -0
- package/dist/commonjs/logger.d.ts.map +1 -0
- package/dist/commonjs/logger.js +8 -0
- package/dist/commonjs/logger.js.map +1 -0
- package/dist/commonjs/package.json +3 -0
- package/dist/commonjs/tsdoc-metadata.json +11 -0
- package/dist/esm/MapsSearch.d.ts +53 -0
- package/dist/esm/MapsSearch.d.ts.map +1 -0
- package/dist/esm/MapsSearch.js +40 -0
- package/dist/esm/MapsSearch.js.map +1 -0
- package/dist/esm/generated/clientDefinitions.d.ts +137 -0
- package/dist/esm/generated/clientDefinitions.d.ts.map +1 -0
- package/dist/esm/generated/clientDefinitions.js +4 -0
- package/dist/esm/generated/clientDefinitions.js.map +1 -0
- package/dist/esm/generated/index.d.ts +10 -0
- package/dist/esm/generated/index.d.ts.map +1 -0
- package/dist/esm/generated/index.js +12 -0
- package/dist/esm/generated/index.js.map +1 -0
- package/dist/esm/generated/isUnexpected.d.ts +7 -0
- package/dist/esm/generated/isUnexpected.d.ts.map +1 -0
- package/dist/esm/generated/isUnexpected.js +75 -0
- package/dist/esm/generated/isUnexpected.js.map +1 -0
- package/dist/esm/generated/logger.d.ts +2 -0
- package/dist/esm/generated/logger.d.ts.map +1 -0
- package/dist/esm/generated/logger.js +5 -0
- package/dist/esm/generated/logger.js.map +1 -0
- package/dist/esm/generated/mapsSearchClient.d.ts +15 -0
- package/dist/esm/generated/mapsSearchClient.d.ts.map +1 -0
- package/dist/esm/generated/mapsSearchClient.js +42 -0
- package/dist/esm/generated/mapsSearchClient.js.map +1 -0
- package/dist/esm/generated/models.d.ts +97 -0
- package/dist/esm/generated/models.d.ts.map +1 -0
- package/dist/esm/generated/models.js +4 -0
- package/dist/esm/generated/models.js.map +1 -0
- package/dist/esm/generated/outputModels.d.ts +298 -0
- package/dist/esm/generated/outputModels.d.ts.map +1 -0
- package/dist/esm/generated/outputModels.js +4 -0
- package/dist/esm/generated/outputModels.js.map +1 -0
- package/dist/esm/generated/parameters.d.ts +135 -0
- package/dist/esm/generated/parameters.d.ts.map +1 -0
- package/dist/esm/generated/parameters.js +4 -0
- package/dist/esm/generated/parameters.js.map +1 -0
- package/dist/esm/generated/responses.d.ts +255 -0
- package/dist/esm/generated/responses.d.ts.map +1 -0
- package/dist/esm/generated/responses.js +4 -0
- package/dist/esm/generated/responses.js.map +1 -0
- package/dist/esm/index.d.ts +4 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +6 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/logger.d.ts +2 -0
- package/dist/esm/logger.d.ts.map +1 -0
- package/dist/esm/logger.js +5 -0
- package/dist/esm/logger.js.map +1 -0
- package/dist/esm/package.json +3 -0
- package/dist/react-native/MapsSearch.d.ts +53 -0
- package/dist/react-native/MapsSearch.d.ts.map +1 -0
- package/dist/react-native/MapsSearch.js +40 -0
- package/dist/react-native/MapsSearch.js.map +1 -0
- package/dist/react-native/generated/clientDefinitions.d.ts +137 -0
- package/dist/react-native/generated/clientDefinitions.d.ts.map +1 -0
- package/dist/react-native/generated/clientDefinitions.js +4 -0
- package/dist/react-native/generated/clientDefinitions.js.map +1 -0
- package/dist/react-native/generated/index.d.ts +10 -0
- package/dist/react-native/generated/index.d.ts.map +1 -0
- package/dist/react-native/generated/index.js +12 -0
- package/dist/react-native/generated/index.js.map +1 -0
- package/dist/react-native/generated/isUnexpected.d.ts +7 -0
- package/dist/react-native/generated/isUnexpected.d.ts.map +1 -0
- package/dist/react-native/generated/isUnexpected.js +75 -0
- package/dist/react-native/generated/isUnexpected.js.map +1 -0
- package/dist/react-native/generated/logger.d.ts +2 -0
- package/dist/react-native/generated/logger.d.ts.map +1 -0
- package/dist/react-native/generated/logger.js +5 -0
- package/dist/react-native/generated/logger.js.map +1 -0
- package/dist/react-native/generated/mapsSearchClient.d.ts +15 -0
- package/dist/react-native/generated/mapsSearchClient.d.ts.map +1 -0
- package/dist/react-native/generated/mapsSearchClient.js +42 -0
- package/dist/react-native/generated/mapsSearchClient.js.map +1 -0
- package/dist/react-native/generated/models.d.ts +97 -0
- package/dist/react-native/generated/models.d.ts.map +1 -0
- package/dist/react-native/generated/models.js +4 -0
- package/dist/react-native/generated/models.js.map +1 -0
- package/dist/react-native/generated/outputModels.d.ts +298 -0
- package/dist/react-native/generated/outputModels.d.ts.map +1 -0
- package/dist/react-native/generated/outputModels.js +4 -0
- package/dist/react-native/generated/outputModels.js.map +1 -0
- package/dist/react-native/generated/parameters.d.ts +135 -0
- package/dist/react-native/generated/parameters.d.ts.map +1 -0
- package/dist/react-native/generated/parameters.js +4 -0
- package/dist/react-native/generated/parameters.js.map +1 -0
- package/dist/react-native/generated/responses.d.ts +255 -0
- package/dist/react-native/generated/responses.d.ts.map +1 -0
- package/dist/react-native/generated/responses.js +4 -0
- package/dist/react-native/generated/responses.js.map +1 -0
- package/dist/react-native/index.d.ts +4 -0
- package/dist/react-native/index.d.ts.map +1 -0
- package/dist/react-native/index.js +6 -0
- package/dist/react-native/index.js.map +1 -0
- package/dist/react-native/logger.d.ts +2 -0
- package/dist/react-native/logger.d.ts.map +1 -0
- package/dist/react-native/logger.js +5 -0
- package/dist/react-native/logger.js.map +1 -0
- package/dist/react-native/package.json +3 -0
- package/package.json +75 -54
- package/dist/index.js +0 -171
- package/dist/index.js.map +0 -1
- package/dist-esm/src/MapsSearch.js.map +0 -1
- package/dist-esm/src/index.js +0 -6
- package/dist-esm/src/index.js.map +0 -1
- package/review/maps-search.api.md +0 -549
- package/types/maps-search-rest.d.ts +0 -1066
- /package/{dist-esm/src → dist/browser/generated}/logger.js +0 -0
- /package/{dist-esm/src → dist/browser}/logger.js.map +0 -0
|
@@ -1,1066 +0,0 @@
|
|
|
1
|
-
import type { AzureKeyCredential } from '@azure/core-auth';
|
|
2
|
-
import type { AzureSASCredential } from '@azure/core-auth';
|
|
3
|
-
import { Client } from '@azure-rest/core-client';
|
|
4
|
-
import { ClientOptions } from '@azure-rest/core-client';
|
|
5
|
-
import { HttpResponse } from '@azure-rest/core-client';
|
|
6
|
-
import { RawHttpHeaders } from '@azure/core-rest-pipeline';
|
|
7
|
-
import { RequestParameters } from '@azure-rest/core-client';
|
|
8
|
-
import { StreamableMethod } from '@azure-rest/core-client';
|
|
9
|
-
import type { TokenCredential } from '@azure/core-auth';
|
|
10
|
-
|
|
11
|
-
export declare interface AddressAdminDistrictsItemOutput {
|
|
12
|
-
/**
|
|
13
|
-
* The name for the corresponding adminDistrict field,
|
|
14
|
-
* For adminDistrict[0], this could be full name of state such as Washington,
|
|
15
|
-
* For adminDistrict[1], this could be the full name of the county
|
|
16
|
-
*/
|
|
17
|
-
name?: string;
|
|
18
|
-
/**
|
|
19
|
-
* The short name for the corresponding adminDistrict field,
|
|
20
|
-
* For adminDistrict[0], this could be short name of state such as WA,
|
|
21
|
-
* For adminDistrict[1], this could be the short name of the county
|
|
22
|
-
*/
|
|
23
|
-
shortName?: string;
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
export declare interface AddressCountryRegionOutput {
|
|
27
|
-
/** ISO of country/region */
|
|
28
|
-
ISO?: string;
|
|
29
|
-
/** name of country/region */
|
|
30
|
-
name?: string;
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
/** The address of the result */
|
|
34
|
-
export declare interface AddressOutput {
|
|
35
|
-
/** AddressLine that includes Street Name and Number */
|
|
36
|
-
addressLine?: string;
|
|
37
|
-
/** locality property */
|
|
38
|
-
locality?: string;
|
|
39
|
-
/** neighborhood property */
|
|
40
|
-
neighborhood?: string;
|
|
41
|
-
/** The subdivision name in the country or region for an address. This element is typically treated as the first order administrative subdivision, but in some cases it also contains the second, third, or fourth order subdivision in a country, dependency, or region. */
|
|
42
|
-
adminDistricts?: Array<AddressAdminDistrictsItemOutput>;
|
|
43
|
-
/** Postal Code property */
|
|
44
|
-
postalCode?: string;
|
|
45
|
-
countryRegion?: AddressCountryRegionOutput;
|
|
46
|
-
/** Formatted Address property */
|
|
47
|
-
formattedAddress?: string;
|
|
48
|
-
/** The address of the result. */
|
|
49
|
-
intersection?: IntersectionOutput;
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
/**
|
|
53
|
-
* `GeoJSON GeocodingFeature` object that describe the boundaries of a geographical area. Geometry of the feature is described with `GeoJSON GeometryCollection`.
|
|
54
|
-
*
|
|
55
|
-
* Please note, the service typically returns a GeometryCollection with Polygon or MultiPolygon sub-types.
|
|
56
|
-
*/
|
|
57
|
-
export declare interface BoundaryOutput extends GeoJsonFeatureOutputParent, BoundaryPropertiesOutput {
|
|
58
|
-
type: "Boundary";
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
/** Properties of a Boundary object. */
|
|
62
|
-
export declare interface BoundaryPropertiesOutput {
|
|
63
|
-
/** The name associated with the geographical area. */
|
|
64
|
-
name?: string;
|
|
65
|
-
/** The copyright string. */
|
|
66
|
-
copyright?: string;
|
|
67
|
-
/** A URL that lists many of the data providers for Azure Maps and their related copyright information. */
|
|
68
|
-
copyrightURL?: string;
|
|
69
|
-
/** A collection of copyright information for each geometry of the Boundary object in the same order they appear. */
|
|
70
|
-
geometriesCopyright?: Array<GeometryCopyrightOutput>;
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
/** The resource management error additional info. */
|
|
74
|
-
export declare interface ErrorAdditionalInfoOutput {
|
|
75
|
-
/** The additional info type. */
|
|
76
|
-
readonly type?: string;
|
|
77
|
-
/** The additional info. */
|
|
78
|
-
readonly info?: Record<string, unknown>;
|
|
79
|
-
}
|
|
80
|
-
|
|
81
|
-
/** The error detail. */
|
|
82
|
-
export declare interface ErrorDetailOutput {
|
|
83
|
-
/** The error code. */
|
|
84
|
-
readonly code?: string;
|
|
85
|
-
/** The error message. */
|
|
86
|
-
readonly message?: string;
|
|
87
|
-
/** The error target. */
|
|
88
|
-
readonly target?: string;
|
|
89
|
-
/** The error details. */
|
|
90
|
-
readonly details?: Array<ErrorDetailOutput>;
|
|
91
|
-
/** The error additional info. */
|
|
92
|
-
readonly additionalInfo?: Array<ErrorAdditionalInfoOutput>;
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
/** Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.). */
|
|
96
|
-
export declare interface ErrorResponseOutput {
|
|
97
|
-
/** The error object. */
|
|
98
|
-
error?: ErrorDetailOutput;
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
export declare interface FeaturesItemOutput {
|
|
102
|
-
/** The type of a feature must be Feature. */
|
|
103
|
-
type?: "Feature";
|
|
104
|
-
/** ID for feature returned */
|
|
105
|
-
id?: string;
|
|
106
|
-
properties?: FeaturesItemPropertiesOutput;
|
|
107
|
-
/** A valid `GeoJSON Point` geometry type. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1.2) for details. */
|
|
108
|
-
geometry: GeoJsonPointOutput;
|
|
109
|
-
/** Bounding box. Projection used - EPSG:3857. Please refer to [RFC 7946](https://datatracker.ietf.org/doc/html/rfc7946#section-5) for details. */
|
|
110
|
-
bbox?: Array<number>;
|
|
111
|
-
}
|
|
112
|
-
|
|
113
|
-
export declare interface FeaturesItemPropertiesOutput {
|
|
114
|
-
/**
|
|
115
|
-
* One of:
|
|
116
|
-
* * Address
|
|
117
|
-
* * RoadBlock
|
|
118
|
-
* * RoadIntersection
|
|
119
|
-
* * Neighborhood
|
|
120
|
-
* * PopulatedPlace
|
|
121
|
-
* * Postcode1
|
|
122
|
-
* * AdminDivision1
|
|
123
|
-
* * AdminDivision2
|
|
124
|
-
* * CountryRegion
|
|
125
|
-
*/
|
|
126
|
-
type?: string;
|
|
127
|
-
/**
|
|
128
|
-
* The level of confidence that the geocoded location result is a match. Use this value with the match code to determine for more complete information about the match.
|
|
129
|
-
*
|
|
130
|
-
* The confidence of a geocoded location is based on many factors including the relative importance of the geocoded location and the user’s location, if specified.
|
|
131
|
-
*/
|
|
132
|
-
confidence?: "High" | "Medium" | "Low";
|
|
133
|
-
/**
|
|
134
|
-
* One or more match code values that represent the geocoding level for each location in the response.
|
|
135
|
-
*
|
|
136
|
-
* For example, a geocoded location with match codes of `Good` and `Ambiguous` means that more than one geocode location was found for the location information and that the geocode service did not have search up-hierarchy to find a match.
|
|
137
|
-
*
|
|
138
|
-
* Similarly, a geocoded location with match codes of `Ambiguous` and `UpHierarchy` implies that a geocode location could not be found that matched all the provided location information, so the geocode service had to search up-hierarchy and found multiple matches at that level. An example of up an `Ambiguous` and `UpHierarchy` result is when you provide complete address information, but the geocode service cannot locate a match for the street address and instead returns information for more than one RoadBlock value.
|
|
139
|
-
*
|
|
140
|
-
* The possible values are:
|
|
141
|
-
*
|
|
142
|
-
* `Good`: The location has only one match or all returned matches are considered strong matches. For example, a query for New York returns several Good matches.
|
|
143
|
-
*
|
|
144
|
-
* `Ambiguous`: The location is one of a set of possible matches. For example, when you query for the street address 128 Main St., the response may return two locations for 128 North Main St. and 128 South Main St. because there is not enough information to determine which option to choose.
|
|
145
|
-
*
|
|
146
|
-
* `UpHierarchy`: The location represents a move up the geographic hierarchy. This occurs when a match for the location request was not found, so a less precise result is returned. For example, if a match for the requested address cannot be found, then a match code of `UpHierarchy` with a RoadBlock entity type may be returned.
|
|
147
|
-
*/
|
|
148
|
-
matchCodes?: Array<"Good" | "Ambiguous" | "UpHierarchy">;
|
|
149
|
-
/** The address of the result */
|
|
150
|
-
address?: AddressOutput;
|
|
151
|
-
/** A collection of geocode points that differ in how they were calculated and their suggested use. */
|
|
152
|
-
geocodePoints?: Array<GeocodePointsItemOutput>;
|
|
153
|
-
}
|
|
154
|
-
|
|
155
|
-
export declare interface GeocodePointsItemOutput {
|
|
156
|
-
/** A valid `GeoJSON Point` geometry type. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1.2) for details. */
|
|
157
|
-
geometry?: GeoJsonPointOutput;
|
|
158
|
-
/** The method that was used to compute the geocode point. */
|
|
159
|
-
calculationMethod?: "Interpolation" | "InterpolationOffset" | "Parcel" | "Rooftop";
|
|
160
|
-
/**
|
|
161
|
-
* The best use for the geocode point.
|
|
162
|
-
* Each geocode point is defined as a `Route` point, a `Display` point or both.
|
|
163
|
-
* Use `Route` points if you are creating a route to the location. Use `Display` points if you are showing the location on a map. For example, if the location is a park, a `Route` point may specify an entrance to the park where you can enter with a car, and a `Display` point may be a point that specifies the center of the park.
|
|
164
|
-
*/
|
|
165
|
-
usageTypes?: Array<"Display" | "Route">;
|
|
166
|
-
}
|
|
167
|
-
|
|
168
|
-
/** The list of address geocoding queries/requests to process. The list can contain a max of 100 queries and must contain at least 1 query. */
|
|
169
|
-
export declare interface GeocodingBatchRequestBody {
|
|
170
|
-
/** The list of queries to process. */
|
|
171
|
-
batchItems?: Array<GeocodingBatchRequestItem>;
|
|
172
|
-
}
|
|
173
|
-
|
|
174
|
-
/** Batch Query object */
|
|
175
|
-
export declare interface GeocodingBatchRequestItem {
|
|
176
|
-
/** id of the request which would show in corresponding batchItem */
|
|
177
|
-
optionalId?: string;
|
|
178
|
-
/** Maximum number of responses that will be returned. Default: 5, minimum: 1 and maximum: 20. */
|
|
179
|
-
top?: number;
|
|
180
|
-
/** A string that contains information about a location, such as an address or landmark name. */
|
|
181
|
-
query?: string;
|
|
182
|
-
/**
|
|
183
|
-
* The official street line of an address relative to the area, as specified by the locality, or postalCode, properties. Typical use of this element would be to provide a street address or any official address.
|
|
184
|
-
*
|
|
185
|
-
* **If query is given, should not use this parameter.**
|
|
186
|
-
*/
|
|
187
|
-
addressLine?: string;
|
|
188
|
-
/**
|
|
189
|
-
* Signal for the geocoding result to an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) that is specified e.g. FR./
|
|
190
|
-
*
|
|
191
|
-
* **If query is given, should not use this parameter.**
|
|
192
|
-
*/
|
|
193
|
-
countryRegion?: string;
|
|
194
|
-
/**
|
|
195
|
-
* A rectangular area on the earth defined as a bounding box object. The sides of the rectangles are defined by longitude and latitude values. For more information, see Location and Area Types. When you specify this parameter, the geographical area is taken into account when computing the results of a location query.
|
|
196
|
-
*
|
|
197
|
-
* Example: [lon1, lat1, lon2, lat2]
|
|
198
|
-
*/
|
|
199
|
-
bbox?: Array<number>;
|
|
200
|
-
/** A string that specifies an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). This will alter Geopolitical disputed borders and labels to align with the specified user region. */
|
|
201
|
-
view?: string;
|
|
202
|
-
/** A point on the earth specified as a longitude and latitude. When you specify this parameter, the user’s location is taken into account and the results returned may be more relevant to the user. Example: [lon, lat] */
|
|
203
|
-
coordinates?: Array<number>;
|
|
204
|
-
/**
|
|
205
|
-
* The country subdivision portion of an address, such as WA.
|
|
206
|
-
*
|
|
207
|
-
* **If query is given, should not use this parameter.**
|
|
208
|
-
*/
|
|
209
|
-
adminDistrict?: string;
|
|
210
|
-
/**
|
|
211
|
-
* The county for the structured address, such as King.
|
|
212
|
-
*
|
|
213
|
-
* **If query is given, should not use this parameter.**
|
|
214
|
-
*/
|
|
215
|
-
adminDistrict2?: string;
|
|
216
|
-
/**
|
|
217
|
-
* The named area for the structured address.
|
|
218
|
-
*
|
|
219
|
-
* **If query is given, should not use this parameter.**
|
|
220
|
-
*/
|
|
221
|
-
adminDistrict3?: string;
|
|
222
|
-
/**
|
|
223
|
-
* The locality portion of an address, such as Seattle.
|
|
224
|
-
*
|
|
225
|
-
* **If query is given, should not use this parameter.**
|
|
226
|
-
*/
|
|
227
|
-
locality?: string;
|
|
228
|
-
/**
|
|
229
|
-
* The postal code portion of an address.
|
|
230
|
-
*
|
|
231
|
-
* **If query is given, should not use this parameter.**
|
|
232
|
-
*/
|
|
233
|
-
postalCode?: string;
|
|
234
|
-
}
|
|
235
|
-
|
|
236
|
-
export declare interface GeocodingBatchResponseItemOutput {
|
|
237
|
-
/** id of the batchItem which would be the same as the id in the request */
|
|
238
|
-
optionalId?: string;
|
|
239
|
-
/** The type of a FeatureCollection object must be FeatureCollection. */
|
|
240
|
-
type?: "FeatureCollection";
|
|
241
|
-
features?: Array<FeaturesItemOutput>;
|
|
242
|
-
/** The is the link to the next page of the features returned. If it's the last page, no this field. */
|
|
243
|
-
nextLink?: string;
|
|
244
|
-
/** The error detail. */
|
|
245
|
-
error?: ErrorDetailOutput;
|
|
246
|
-
}
|
|
247
|
-
|
|
248
|
-
/** This object is returned from a successful Geocoding Batch service call. */
|
|
249
|
-
export declare interface GeocodingBatchResponseOutput {
|
|
250
|
-
/** Summary for the batch request */
|
|
251
|
-
summary?: GeocodingBatchResponseSummaryOutput;
|
|
252
|
-
/** Array containing the batch results. */
|
|
253
|
-
batchItems?: Array<GeocodingBatchResponseItemOutput>;
|
|
254
|
-
/** The is the link to the next page of the features returned. If it's the last page, no this field. */
|
|
255
|
-
nextLink?: string;
|
|
256
|
-
}
|
|
257
|
-
|
|
258
|
-
/** Summary for the batch request */
|
|
259
|
-
export declare interface GeocodingBatchResponseSummaryOutput {
|
|
260
|
-
/** Number of successful requests in the batch */
|
|
261
|
-
successfulRequests?: number;
|
|
262
|
-
/** Total number of requests in the batch */
|
|
263
|
-
totalRequests?: number;
|
|
264
|
-
}
|
|
265
|
-
|
|
266
|
-
/** This object is returned from a successful Geocoding call */
|
|
267
|
-
export declare interface GeocodingResponseOutput {
|
|
268
|
-
/** The type of a FeatureCollection object must be FeatureCollection. */
|
|
269
|
-
type?: "FeatureCollection";
|
|
270
|
-
features?: Array<FeaturesItemOutput>;
|
|
271
|
-
/** The is the link to the next page of the features returned. If it's the last page, no this field. */
|
|
272
|
-
nextLink?: string;
|
|
273
|
-
}
|
|
274
|
-
|
|
275
|
-
export declare interface GeoJsonFeatureCollectionDataOutput {
|
|
276
|
-
/** Contains a list of valid `GeoJSON Feature` objects. */
|
|
277
|
-
features: Array<GeoJsonFeatureOutput>;
|
|
278
|
-
}
|
|
279
|
-
|
|
280
|
-
/** A valid `GeoJSON FeatureCollection` object type. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. */
|
|
281
|
-
export declare interface GeoJsonFeatureCollectionOutput extends GeoJsonObjectOutputParent, GeoJsonFeatureCollectionDataOutput {
|
|
282
|
-
type: "FeatureCollection";
|
|
283
|
-
}
|
|
284
|
-
|
|
285
|
-
export declare interface GeoJsonFeatureDataOutput {
|
|
286
|
-
/** A valid `GeoJSON` geometry object. The type must be one of the seven valid GeoJSON geometry types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon and GeometryCollection. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1) for details. */
|
|
287
|
-
geometry: GeoJsonGeometryOutput;
|
|
288
|
-
/** Properties can contain any additional metadata about the `Feature`. Value can be any JSON object or a JSON null value */
|
|
289
|
-
properties?: Record<string, unknown>;
|
|
290
|
-
/** Identifier for the feature. */
|
|
291
|
-
id?: string;
|
|
292
|
-
/** The type of the feature. The value depends on the data model the current feature is part of. Some data models may have an empty value. */
|
|
293
|
-
featureType?: string;
|
|
294
|
-
}
|
|
295
|
-
|
|
296
|
-
/** A valid `GeoJSON Feature` object type. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.2) for details. */
|
|
297
|
-
export declare type GeoJsonFeatureOutput = GeoJsonFeatureOutputParent | BoundaryOutput;
|
|
298
|
-
|
|
299
|
-
/** A valid `GeoJSON Feature` object type. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.2) for details. */
|
|
300
|
-
export declare interface GeoJsonFeatureOutputParent extends GeoJsonObjectOutputParent, GeoJsonFeatureDataOutput {
|
|
301
|
-
type: "Feature" | "Boundary";
|
|
302
|
-
}
|
|
303
|
-
|
|
304
|
-
export declare interface GeoJsonGeometryCollectionDataOutput {
|
|
305
|
-
/** Contains a list of valid `GeoJSON` geometry objects. **Note** that coordinates in GeoJSON are in x, y order (longitude, latitude). */
|
|
306
|
-
geometries: Array<GeoJsonGeometryOutput>;
|
|
307
|
-
}
|
|
308
|
-
|
|
309
|
-
/** A valid `GeoJSON GeometryCollection` object type. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1.8) for details. */
|
|
310
|
-
export declare interface GeoJsonGeometryCollectionOutput extends GeoJsonGeometryOutputParent, GeoJsonGeometryCollectionDataOutput {
|
|
311
|
-
type: "GeometryCollection";
|
|
312
|
-
}
|
|
313
|
-
|
|
314
|
-
/** A valid `GeoJSON` geometry object. The type must be one of the seven valid GeoJSON geometry types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon and GeometryCollection. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1) for details. */
|
|
315
|
-
export declare type GeoJsonGeometryOutput = GeoJsonGeometryOutputParent | GeoJsonPointOutput | GeoJsonMultiPointOutput | GeoJsonLineStringOutput | GeoJsonMultiLineStringOutput | GeoJsonPolygonOutput | GeoJsonMultiPolygonOutput | GeoJsonGeometryCollectionOutput;
|
|
316
|
-
|
|
317
|
-
/** A valid `GeoJSON` geometry object. The type must be one of the seven valid GeoJSON geometry types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon and GeometryCollection. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1) for details. */
|
|
318
|
-
export declare interface GeoJsonGeometryOutputParent extends GeoJsonObjectOutputParent {
|
|
319
|
-
type: "GeoJsonGeometry" | "Point" | "MultiPoint" | "LineString" | "MultiLineString" | "Polygon" | "MultiPolygon" | "GeometryCollection";
|
|
320
|
-
}
|
|
321
|
-
|
|
322
|
-
export declare interface GeoJsonLineStringDataOutput {
|
|
323
|
-
/** Coordinates for the `GeoJson LineString` geometry. */
|
|
324
|
-
coordinates: Array<Array<number>>;
|
|
325
|
-
}
|
|
326
|
-
|
|
327
|
-
/** A valid `GeoJSON LineString` geometry type. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1.4) for details. */
|
|
328
|
-
export declare interface GeoJsonLineStringOutput extends GeoJsonGeometryOutputParent, GeoJsonLineStringDataOutput {
|
|
329
|
-
type: "LineString";
|
|
330
|
-
}
|
|
331
|
-
|
|
332
|
-
export declare interface GeoJsonMultiLineStringDataOutput {
|
|
333
|
-
/** Coordinates for the `GeoJson MultiLineString` geometry. */
|
|
334
|
-
coordinates: Array<Array<Array<number>>>;
|
|
335
|
-
}
|
|
336
|
-
|
|
337
|
-
/** A valid `GeoJSON MultiLineString` geometry type. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1.5) for details. */
|
|
338
|
-
export declare interface GeoJsonMultiLineStringOutput extends GeoJsonGeometryOutputParent, GeoJsonMultiLineStringDataOutput {
|
|
339
|
-
type: "MultiLineString";
|
|
340
|
-
}
|
|
341
|
-
|
|
342
|
-
/** Data contained by a `GeoJson MultiPoint`. */
|
|
343
|
-
export declare interface GeoJsonMultiPointDataOutput {
|
|
344
|
-
/** Coordinates for the `GeoJson MultiPoint` geometry. */
|
|
345
|
-
coordinates: Array<Array<number>>;
|
|
346
|
-
}
|
|
347
|
-
|
|
348
|
-
/** A valid `GeoJSON MultiPoint` geometry type. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1.3) for details. */
|
|
349
|
-
export declare interface GeoJsonMultiPointOutput extends GeoJsonGeometryOutputParent, GeoJsonMultiPointDataOutput {
|
|
350
|
-
type: "MultiPoint";
|
|
351
|
-
}
|
|
352
|
-
|
|
353
|
-
export declare interface GeoJsonMultiPolygonDataOutput {
|
|
354
|
-
/** Contains a list of valid `GeoJSON Polygon` objects. **Note** that coordinates in GeoJSON are in x, y order (longitude, latitude). */
|
|
355
|
-
coordinates: Array<Array<Array<Array<number>>>>;
|
|
356
|
-
}
|
|
357
|
-
|
|
358
|
-
/** A valid `GeoJSON MultiPolygon` object type. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1.7) for details. */
|
|
359
|
-
export declare interface GeoJsonMultiPolygonOutput extends GeoJsonGeometryOutputParent, GeoJsonMultiPolygonDataOutput {
|
|
360
|
-
type: "MultiPolygon";
|
|
361
|
-
}
|
|
362
|
-
|
|
363
|
-
/** A valid `GeoJSON` object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3) for details. */
|
|
364
|
-
export declare type GeoJsonObjectOutput = GeoJsonGeometryOutput | GeoJsonPointOutput | GeoJsonFeatureOutput | BoundaryOutput | GeoJsonMultiPointOutput | GeoJsonLineStringOutput | GeoJsonMultiLineStringOutput | GeoJsonPolygonOutput | GeoJsonMultiPolygonOutput | GeoJsonGeometryCollectionOutput | GeoJsonFeatureCollectionOutput;
|
|
365
|
-
|
|
366
|
-
/** A valid `GeoJSON` object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3) for details. */
|
|
367
|
-
export declare interface GeoJsonObjectOutputParent {
|
|
368
|
-
/** Bounding box. Projection used - EPSG:3857. Please refer to [RFC 7946](https://datatracker.ietf.org/doc/html/rfc7946#section-5) for details. */
|
|
369
|
-
bbox?: Array<number>;
|
|
370
|
-
type: "GeoJsonObject" | "GeoJsonGeometry" | "Point" | "Feature" | "Boundary" | "MultiPoint" | "LineString" | "MultiLineString" | "Polygon" | "MultiPolygon" | "GeometryCollection" | "FeatureCollection";
|
|
371
|
-
}
|
|
372
|
-
|
|
373
|
-
/** Data contained by a `GeoJson Point`. */
|
|
374
|
-
export declare interface GeoJsonPointDataOutput {
|
|
375
|
-
/** A `Position` is an array of numbers with two or more elements. The first two elements are _longitude_ and _latitude_, precisely in that order. _Altitude/Elevation_ is an optional third element. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1.1) for details. */
|
|
376
|
-
coordinates: Array<number>;
|
|
377
|
-
}
|
|
378
|
-
|
|
379
|
-
/** A valid `GeoJSON Point` geometry type. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1.2) for details. */
|
|
380
|
-
export declare interface GeoJsonPointOutput extends GeoJsonGeometryOutputParent, GeoJsonPointDataOutput {
|
|
381
|
-
type: "Point";
|
|
382
|
-
}
|
|
383
|
-
|
|
384
|
-
export declare interface GeoJsonPolygonDataOutput {
|
|
385
|
-
/** Coordinates for the `GeoJson Polygon` geometry type. */
|
|
386
|
-
coordinates: Array<Array<Array<number>>>;
|
|
387
|
-
}
|
|
388
|
-
|
|
389
|
-
/** A valid `GeoJSON Polygon` geometry type. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1.6) for details. */
|
|
390
|
-
export declare interface GeoJsonPolygonOutput extends GeoJsonGeometryOutputParent, GeoJsonPolygonDataOutput {
|
|
391
|
-
type: "Polygon";
|
|
392
|
-
}
|
|
393
|
-
|
|
394
|
-
/** Copyright information of a geometry of a Boundary object. */
|
|
395
|
-
export declare interface GeometryCopyrightOutput {
|
|
396
|
-
/** The name of the data provider */
|
|
397
|
-
sourceName?: string;
|
|
398
|
-
/** The copyright string for the data provider */
|
|
399
|
-
copyright?: string;
|
|
400
|
-
}
|
|
401
|
-
|
|
402
|
-
export declare interface GetGeocoding {
|
|
403
|
-
/**
|
|
404
|
-
*
|
|
405
|
-
* The `Get Geocoding` API is an HTTP `GET` request that returns the longitude and latitude coordinates of the location being searched.
|
|
406
|
-
*
|
|
407
|
-
* In many cases, the complete search service might be too much, for instance if you are only interested in traditional geocoding. Search can also be accessed for address look up exclusively. The geocoding is performed by hitting the geocoding endpoint with just the address or partial address in question. The geocoding search index will be queried for everything above the street level data. No Point of Interest (POIs) will be returned. Note that the geocoder is very tolerant of typos and incomplete addresses. It will also handle everything from exact street addresses or street or intersections as well as higher level geographies such as city centers, counties and states. The response also returns detailed address properties such as street, postal code, municipality, and country/region information.
|
|
408
|
-
*/
|
|
409
|
-
get(options?: SearchGetGeocodingParameters): StreamableMethod<SearchGetGeocoding200Response | SearchGetGeocodingDefaultResponse>;
|
|
410
|
-
}
|
|
411
|
-
|
|
412
|
-
export declare interface GetGeocodingBatch {
|
|
413
|
-
/**
|
|
414
|
-
*
|
|
415
|
-
* The `Get Geocoding Batch` API is an HTTP `POST` request that sends batches of up to **100** queries to the [Geocoding](/rest/api/maps/search/get-geocoding) API in a single request.
|
|
416
|
-
*
|
|
417
|
-
* ### Submit Synchronous Batch Request
|
|
418
|
-
* The Synchronous API is recommended for lightweight batch requests. When the service receives a request, it will respond as soon as the batch items are calculated and there will be no possibility to retrieve the results later. The Synchronous API will return a timeout error (a 408 response) if the request takes longer than 60 seconds. The number of batch items is limited to **100** for this API.
|
|
419
|
-
* ```
|
|
420
|
-
* POST https://atlas.microsoft.com/geocode:batch?api-version=2023-06-01
|
|
421
|
-
* ```
|
|
422
|
-
* ### POST Body for Batch Request
|
|
423
|
-
* To send the _geocoding_ queries you will use a `POST` request where the request body will contain the `batchItems` array in `json` format and the `Content-Type` header will be set to `application/json`. Here's a sample request body containing 2 _geocoding_ queries:
|
|
424
|
-
*
|
|
425
|
-
*
|
|
426
|
-
* ```
|
|
427
|
-
* {
|
|
428
|
-
* "batchItems": [
|
|
429
|
-
* {
|
|
430
|
-
* "addressLine": "One, Microsoft Way, Redmond, WA 98052",
|
|
431
|
-
* "top": 2
|
|
432
|
-
* },
|
|
433
|
-
* {
|
|
434
|
-
* "addressLine": "Pike Pl",
|
|
435
|
-
* "adminDistrict": "WA",
|
|
436
|
-
* "locality": "Seattle",
|
|
437
|
-
* "top": 3
|
|
438
|
-
* }
|
|
439
|
-
* ]
|
|
440
|
-
* }
|
|
441
|
-
* ```
|
|
442
|
-
*
|
|
443
|
-
* A _geocoding_ batchItem object can accept any of the supported _geocoding_ [URI parameters](/rest/api/maps/search/get-geocoding#uri-parameters).
|
|
444
|
-
*
|
|
445
|
-
*
|
|
446
|
-
* The batch should contain at least **1** query.
|
|
447
|
-
*
|
|
448
|
-
*
|
|
449
|
-
* ### Batch Response Model
|
|
450
|
-
* The batch response contains a `summary` component that indicates the `totalRequests` that were part of the original batch request and `successfulRequests` i.e. queries which were executed successfully. The batch response also includes a `batchItems` array which contains a response for each and every query in the batch request. The `batchItems` will contain the results in the exact same order the original queries were sent in the batch request. Each item is of one of the following types:
|
|
451
|
-
*
|
|
452
|
-
* - [`GeocodingResponse`](/rest/api/maps/search/get-geocoding#geocodingresponse) - If the query completed successfully.
|
|
453
|
-
*
|
|
454
|
-
* - `Error` - If the query failed. The response will contain a `code` and a `message` in this case.
|
|
455
|
-
*
|
|
456
|
-
*
|
|
457
|
-
*
|
|
458
|
-
*/
|
|
459
|
-
post(options: SearchGetGeocodingBatchParameters): StreamableMethod<SearchGetGeocodingBatch200Response | SearchGetGeocodingBatchDefaultResponse>;
|
|
460
|
-
}
|
|
461
|
-
|
|
462
|
-
export declare interface GetPolygon {
|
|
463
|
-
/**
|
|
464
|
-
*
|
|
465
|
-
* The `Get Polygon` API is an HTTP `GET` request that supplies polygon data of a geographical area outline such as a city or a country region.
|
|
466
|
-
*/
|
|
467
|
-
get(options: SearchGetPolygonParameters): StreamableMethod<SearchGetPolygon200Response | SearchGetPolygonDefaultResponse>;
|
|
468
|
-
}
|
|
469
|
-
|
|
470
|
-
export declare interface GetReverseGeocoding {
|
|
471
|
-
/**
|
|
472
|
-
*
|
|
473
|
-
* The `Get Reverse Geocoding` API is an HTTP `GET` request used to translate a coordinate (example: 37.786505, -122.3862) into a human understandable street address. Useful in tracking applications where you receive a GPS feed from the device or asset and wish to know the address associated with the coordinates. This endpoint will return address information for a given coordinate.
|
|
474
|
-
*/
|
|
475
|
-
get(options: SearchGetReverseGeocodingParameters): StreamableMethod<SearchGetReverseGeocoding200Response | SearchGetReverseGeocodingDefaultResponse>;
|
|
476
|
-
}
|
|
477
|
-
|
|
478
|
-
export declare interface GetReverseGeocodingBatch {
|
|
479
|
-
/**
|
|
480
|
-
*
|
|
481
|
-
* The `Get Reverse Geocoding Batch` API is an HTTP `POST` request that sends batches of up to **100** queries to [Reverse Geocoding](/rest/api/maps/search/get-reverse-geocoding) API using a single request.
|
|
482
|
-
*
|
|
483
|
-
* ### Submit Synchronous Batch Request
|
|
484
|
-
* The Synchronous API is recommended for lightweight batch requests. When the service receives a request, it will respond as soon as the batch items are calculated and there will be no possibility to retrieve the results later. The Synchronous API will return a timeout error (a 408 response) if the request takes longer than 60 seconds. The number of batch items is limited to **100** for this API.
|
|
485
|
-
* ```
|
|
486
|
-
* POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01
|
|
487
|
-
* ```
|
|
488
|
-
* ### POST Body for Batch Request
|
|
489
|
-
* To send the _reverse geocoding_ queries you will use a `POST` request where the request body will contain the `batchItems` array in `json` format and the `Content-Type` header will be set to `application/json`. Here's a sample request body containing 2 _reverse geocoding_ queries:
|
|
490
|
-
*
|
|
491
|
-
*
|
|
492
|
-
* ```
|
|
493
|
-
* {
|
|
494
|
-
* "batchItems": [
|
|
495
|
-
* {
|
|
496
|
-
* "coordinates": [-122.128275, 47.639429],
|
|
497
|
-
* "resultTypes": ["Address", "PopulatedPlace"]
|
|
498
|
-
* },
|
|
499
|
-
* {
|
|
500
|
-
* "coordinates": [-122.341979399674, 47.6095253501216]
|
|
501
|
-
* }
|
|
502
|
-
* ]
|
|
503
|
-
* }
|
|
504
|
-
* ```
|
|
505
|
-
*
|
|
506
|
-
* A _reverse geocoding_ batchItem object can accept any of the supported _reverse geocoding_ [URI parameters](/rest/api/maps/search/get-reverse-geocoding#uri-parameters).
|
|
507
|
-
*
|
|
508
|
-
*
|
|
509
|
-
* The batch should contain at least **1** query.
|
|
510
|
-
*
|
|
511
|
-
*
|
|
512
|
-
* ### Batch Response Model
|
|
513
|
-
* The batch response contains a `summary` component that indicates the `totalRequests` that were part of the original batch request and `successfulRequests` i.e. queries which were executed successfully. The batch response also includes a `batchItems` array which contains a response for each and every query in the batch request. The `batchItems` will contain the results in the exact same order the original queries were sent in the batch request. Each item is of one of the following types:
|
|
514
|
-
*
|
|
515
|
-
* - [`GeocodingResponse`](/rest/api/maps/search/get-reverse-geocoding#geocodingresponse) - If the query completed successfully.
|
|
516
|
-
*
|
|
517
|
-
* - `Error` - If the query failed. The response will contain a `code` and a `message` in this case.
|
|
518
|
-
*
|
|
519
|
-
*
|
|
520
|
-
*
|
|
521
|
-
*/
|
|
522
|
-
post(options: SearchGetReverseGeocodingBatchParameters): StreamableMethod<SearchGetReverseGeocodingBatch200Response | SearchGetReverseGeocodingBatchDefaultResponse>;
|
|
523
|
-
}
|
|
524
|
-
|
|
525
|
-
/** The address of the result. */
|
|
526
|
-
export declare interface IntersectionOutput {
|
|
527
|
-
/** Primary street for the location. */
|
|
528
|
-
baseStreet?: string;
|
|
529
|
-
/** The first intersecting street. */
|
|
530
|
-
secondaryStreet1?: string;
|
|
531
|
-
/** If any, the second intersecting street. */
|
|
532
|
-
secondaryStreet2?: string;
|
|
533
|
-
/** Type of intersection. */
|
|
534
|
-
intersectionType?: string;
|
|
535
|
-
/** Complete name of the intersection. */
|
|
536
|
-
displayName?: string;
|
|
537
|
-
}
|
|
538
|
-
|
|
539
|
-
export declare function isUnexpected(response: SearchGetGeocoding200Response | SearchGetGeocodingDefaultResponse): response is SearchGetGeocodingDefaultResponse;
|
|
540
|
-
|
|
541
|
-
export declare function isUnexpected(response: SearchGetGeocodingBatch200Response | SearchGetGeocodingBatchDefaultResponse): response is SearchGetGeocodingBatchDefaultResponse;
|
|
542
|
-
|
|
543
|
-
export declare function isUnexpected(response: SearchGetPolygon200Response | SearchGetPolygonDefaultResponse): response is SearchGetPolygonDefaultResponse;
|
|
544
|
-
|
|
545
|
-
export declare function isUnexpected(response: SearchGetReverseGeocoding200Response | SearchGetReverseGeocodingDefaultResponse): response is SearchGetReverseGeocodingDefaultResponse;
|
|
546
|
-
|
|
547
|
-
export declare function isUnexpected(response: SearchGetReverseGeocodingBatch200Response | SearchGetReverseGeocodingBatchDefaultResponse): response is SearchGetReverseGeocodingBatchDefaultResponse;
|
|
548
|
-
|
|
549
|
-
/**
|
|
550
|
-
* Creates an instance of MapsSearchClient from a subscription key.
|
|
551
|
-
*
|
|
552
|
-
* @example
|
|
553
|
-
* ```ts
|
|
554
|
-
* import MapsSearch from "@azure-rest/maps-search";
|
|
555
|
-
* import { AzureKeyCredential } from "@azure/core-auth";
|
|
556
|
-
*
|
|
557
|
-
* const credential = new AzureKeyCredential("<subscription-key>");
|
|
558
|
-
* const client = MapsSearch(credential);
|
|
559
|
-
*```
|
|
560
|
-
*
|
|
561
|
-
* @param credential - An AzureKeyCredential instance used to authenticate requests to the service
|
|
562
|
-
* @param options - Options used to configure the Search Client
|
|
563
|
-
*/
|
|
564
|
-
declare function MapsSearch(credential: AzureKeyCredential, options?: ClientOptions): MapsSearchClient;
|
|
565
|
-
|
|
566
|
-
/**
|
|
567
|
-
* Creates an instance of MapsSearch from an Azure Identity `TokenCredential`.
|
|
568
|
-
*
|
|
569
|
-
* @example
|
|
570
|
-
* ```ts
|
|
571
|
-
* import MapsSearch from "@azure-rest/maps-search";
|
|
572
|
-
* import { DefaultAzureCredential } from "@azure/identity";
|
|
573
|
-
*
|
|
574
|
-
* const credential = new DefaultAzureCredential();
|
|
575
|
-
* const client = MapsSearch(credential, "<maps-account-client-id>");
|
|
576
|
-
*```
|
|
577
|
-
*
|
|
578
|
-
* @param credential - An TokenCredential instance used to authenticate requests to the service
|
|
579
|
-
* @param mapsAccountClientId - The Azure Maps client id of a specific map resource
|
|
580
|
-
* @param options - Options used to configure the Search Client
|
|
581
|
-
*/
|
|
582
|
-
declare function MapsSearch(credential: TokenCredential, mapsAccountClientId: string, options?: ClientOptions): MapsSearchClient;
|
|
583
|
-
|
|
584
|
-
/**
|
|
585
|
-
* Creates an instance of MapsSearch from an Azure Identity `AzureSASCredential`.
|
|
586
|
-
*
|
|
587
|
-
* @example
|
|
588
|
-
* ```ts
|
|
589
|
-
* import MapsSearch from "@azure-rest/maps-search";
|
|
590
|
-
* import { AzureSASCredential } from "@azure/core-auth";
|
|
591
|
-
*
|
|
592
|
-
* const credential = new AzureSASCredential("<SAS Token>");
|
|
593
|
-
* const client = MapsSearch(credential);
|
|
594
|
-
* ```
|
|
595
|
-
*
|
|
596
|
-
* @param credential - An AzureSASCredential instance used to authenticate requests to the service
|
|
597
|
-
* @param options - Options used to configure the Search Client
|
|
598
|
-
*/
|
|
599
|
-
declare function MapsSearch(credential: AzureSASCredential, options?: ClientOptions): MapsSearchClient;
|
|
600
|
-
export default MapsSearch;
|
|
601
|
-
|
|
602
|
-
export declare type MapsSearchClient = Client & {
|
|
603
|
-
path: Routes;
|
|
604
|
-
};
|
|
605
|
-
|
|
606
|
-
/** The optional parameters for the client */
|
|
607
|
-
export declare interface MapsSearchClientOptions extends ClientOptions {
|
|
608
|
-
/** The api version option of the client */
|
|
609
|
-
apiVersion?: string;
|
|
610
|
-
}
|
|
611
|
-
|
|
612
|
-
/** The list of reverse geocoding queries/requests to process. The list can contain a max of 100 queries and must contain at least 1 query. */
|
|
613
|
-
export declare interface ReverseGeocodingBatchRequestBody {
|
|
614
|
-
/** The list of queries to process. */
|
|
615
|
-
batchItems?: Array<ReverseGeocodingBatchRequestItem>;
|
|
616
|
-
}
|
|
617
|
-
|
|
618
|
-
/** Batch Query object */
|
|
619
|
-
export declare interface ReverseGeocodingBatchRequestItem {
|
|
620
|
-
/** id of the request which would show in corresponding batchItem */
|
|
621
|
-
optionalId?: string;
|
|
622
|
-
/** The coordinates of the location that you want to reverse geocode. Example: [lon,lat] */
|
|
623
|
-
coordinates?: Array<number>;
|
|
624
|
-
/**
|
|
625
|
-
* Specify entity types that you want in the response. Only the types you specify will be returned. If the point cannot be mapped to the entity types you specify, no location information is returned in the response.
|
|
626
|
-
* Default value is all possible entities.
|
|
627
|
-
* A comma separated list of entity types selected from the following options.
|
|
628
|
-
*
|
|
629
|
-
* - Address
|
|
630
|
-
* - Neighborhood
|
|
631
|
-
* - PopulatedPlace
|
|
632
|
-
* - Postcode1
|
|
633
|
-
* - AdminDivision1
|
|
634
|
-
* - AdminDivision2
|
|
635
|
-
* - CountryRegion
|
|
636
|
-
*
|
|
637
|
-
* These entity types are ordered from the most specific entity to the least specific entity. When entities of more than one entity type are found, only the most specific entity is returned. For example, if you specify Address and AdminDistrict1 as entity types and entities were found for both types, only the Address entity information is returned in the response.
|
|
638
|
-
*/
|
|
639
|
-
resultTypes?: Array<"Address" | "Neighborhood" | "PopulatedPlace" | "Postcode1" | "AdminDivision1" | "AdminDivision2" | "CountryRegion">;
|
|
640
|
-
/** A string that specifies an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). This will alter Geopolitical disputed borders and labels to align with the specified user region. */
|
|
641
|
-
view?: string;
|
|
642
|
-
}
|
|
643
|
-
|
|
644
|
-
export declare interface Routes {
|
|
645
|
-
/** Resource for '/geocode' has methods for the following verbs: get */
|
|
646
|
-
(path: "/geocode"): GetGeocoding;
|
|
647
|
-
/** Resource for '/geocode:batch' has methods for the following verbs: post */
|
|
648
|
-
(path: "/geocode:batch"): GetGeocodingBatch;
|
|
649
|
-
/** Resource for '/search/polygon' has methods for the following verbs: get */
|
|
650
|
-
(path: "/search/polygon"): GetPolygon;
|
|
651
|
-
/** Resource for '/reverseGeocode' has methods for the following verbs: get */
|
|
652
|
-
(path: "/reverseGeocode"): GetReverseGeocoding;
|
|
653
|
-
/** Resource for '/reverseGeocode:batch' has methods for the following verbs: post */
|
|
654
|
-
(path: "/reverseGeocode:batch"): GetReverseGeocodingBatch;
|
|
655
|
-
}
|
|
656
|
-
|
|
657
|
-
export declare interface SearchGetGeocoding200Headers {
|
|
658
|
-
/** request id. */
|
|
659
|
-
"x-ms-request-id"?: string;
|
|
660
|
-
}
|
|
661
|
-
|
|
662
|
-
/**
|
|
663
|
-
*
|
|
664
|
-
* The `Get Geocoding` API is an HTTP `GET` request that returns the longitude and latitude coordinates of the location being searched.
|
|
665
|
-
*
|
|
666
|
-
* In many cases, the complete search service might be too much, for instance if you are only interested in traditional geocoding. Search can also be accessed for address look up exclusively. The geocoding is performed by hitting the geocoding endpoint with just the address or partial address in question. The geocoding search index will be queried for everything above the street level data. No Point of Interest (POIs) will be returned. Note that the geocoder is very tolerant of typos and incomplete addresses. It will also handle everything from exact street addresses or street or intersections as well as higher level geographies such as city centers, counties and states. The response also returns detailed address properties such as street, postal code, municipality, and country/region information.
|
|
667
|
-
*/
|
|
668
|
-
export declare interface SearchGetGeocoding200Response extends HttpResponse {
|
|
669
|
-
status: "200";
|
|
670
|
-
body: GeocodingResponseOutput;
|
|
671
|
-
headers: RawHttpHeaders & SearchGetGeocoding200Headers;
|
|
672
|
-
}
|
|
673
|
-
|
|
674
|
-
/**
|
|
675
|
-
*
|
|
676
|
-
* The `Get Geocoding Batch` API is an HTTP `POST` request that sends batches of up to **100** queries to the [Geocoding](/rest/api/maps/search/get-geocoding) API in a single request.
|
|
677
|
-
*
|
|
678
|
-
* ### Submit Synchronous Batch Request
|
|
679
|
-
* The Synchronous API is recommended for lightweight batch requests. When the service receives a request, it will respond as soon as the batch items are calculated and there will be no possibility to retrieve the results later. The Synchronous API will return a timeout error (a 408 response) if the request takes longer than 60 seconds. The number of batch items is limited to **100** for this API.
|
|
680
|
-
* ```
|
|
681
|
-
* POST https://atlas.microsoft.com/geocode:batch?api-version=2023-06-01
|
|
682
|
-
* ```
|
|
683
|
-
* ### POST Body for Batch Request
|
|
684
|
-
* To send the _geocoding_ queries you will use a `POST` request where the request body will contain the `batchItems` array in `json` format and the `Content-Type` header will be set to `application/json`. Here's a sample request body containing 2 _geocoding_ queries:
|
|
685
|
-
*
|
|
686
|
-
*
|
|
687
|
-
* ```
|
|
688
|
-
* {
|
|
689
|
-
* "batchItems": [
|
|
690
|
-
* {
|
|
691
|
-
* "addressLine": "One, Microsoft Way, Redmond, WA 98052",
|
|
692
|
-
* "top": 2
|
|
693
|
-
* },
|
|
694
|
-
* {
|
|
695
|
-
* "addressLine": "Pike Pl",
|
|
696
|
-
* "adminDistrict": "WA",
|
|
697
|
-
* "locality": "Seattle",
|
|
698
|
-
* "top": 3
|
|
699
|
-
* }
|
|
700
|
-
* ]
|
|
701
|
-
* }
|
|
702
|
-
* ```
|
|
703
|
-
*
|
|
704
|
-
* A _geocoding_ batchItem object can accept any of the supported _geocoding_ [URI parameters](/rest/api/maps/search/get-geocoding#uri-parameters).
|
|
705
|
-
*
|
|
706
|
-
*
|
|
707
|
-
* The batch should contain at least **1** query.
|
|
708
|
-
*
|
|
709
|
-
*
|
|
710
|
-
* ### Batch Response Model
|
|
711
|
-
* The batch response contains a `summary` component that indicates the `totalRequests` that were part of the original batch request and `successfulRequests` i.e. queries which were executed successfully. The batch response also includes a `batchItems` array which contains a response for each and every query in the batch request. The `batchItems` will contain the results in the exact same order the original queries were sent in the batch request. Each item is of one of the following types:
|
|
712
|
-
*
|
|
713
|
-
* - [`GeocodingResponse`](/rest/api/maps/search/get-geocoding#geocodingresponse) - If the query completed successfully.
|
|
714
|
-
*
|
|
715
|
-
* - `Error` - If the query failed. The response will contain a `code` and a `message` in this case.
|
|
716
|
-
*
|
|
717
|
-
*
|
|
718
|
-
*
|
|
719
|
-
*/
|
|
720
|
-
export declare interface SearchGetGeocodingBatch200Response extends HttpResponse {
|
|
721
|
-
status: "200";
|
|
722
|
-
body: GeocodingBatchResponseOutput;
|
|
723
|
-
}
|
|
724
|
-
|
|
725
|
-
export declare interface SearchGetGeocodingBatchBodyParam {
|
|
726
|
-
/** The list of address geocoding queries/requests to process. The list can contain a max of 100 queries and must contain at least 1 query. */
|
|
727
|
-
body: GeocodingBatchRequestBody;
|
|
728
|
-
}
|
|
729
|
-
|
|
730
|
-
/**
|
|
731
|
-
*
|
|
732
|
-
* The `Get Geocoding Batch` API is an HTTP `POST` request that sends batches of up to **100** queries to the [Geocoding](/rest/api/maps/search/get-geocoding) API in a single request.
|
|
733
|
-
*
|
|
734
|
-
* ### Submit Synchronous Batch Request
|
|
735
|
-
* The Synchronous API is recommended for lightweight batch requests. When the service receives a request, it will respond as soon as the batch items are calculated and there will be no possibility to retrieve the results later. The Synchronous API will return a timeout error (a 408 response) if the request takes longer than 60 seconds. The number of batch items is limited to **100** for this API.
|
|
736
|
-
* ```
|
|
737
|
-
* POST https://atlas.microsoft.com/geocode:batch?api-version=2023-06-01
|
|
738
|
-
* ```
|
|
739
|
-
* ### POST Body for Batch Request
|
|
740
|
-
* To send the _geocoding_ queries you will use a `POST` request where the request body will contain the `batchItems` array in `json` format and the `Content-Type` header will be set to `application/json`. Here's a sample request body containing 2 _geocoding_ queries:
|
|
741
|
-
*
|
|
742
|
-
*
|
|
743
|
-
* ```
|
|
744
|
-
* {
|
|
745
|
-
* "batchItems": [
|
|
746
|
-
* {
|
|
747
|
-
* "addressLine": "One, Microsoft Way, Redmond, WA 98052",
|
|
748
|
-
* "top": 2
|
|
749
|
-
* },
|
|
750
|
-
* {
|
|
751
|
-
* "addressLine": "Pike Pl",
|
|
752
|
-
* "adminDistrict": "WA",
|
|
753
|
-
* "locality": "Seattle",
|
|
754
|
-
* "top": 3
|
|
755
|
-
* }
|
|
756
|
-
* ]
|
|
757
|
-
* }
|
|
758
|
-
* ```
|
|
759
|
-
*
|
|
760
|
-
* A _geocoding_ batchItem object can accept any of the supported _geocoding_ [URI parameters](/rest/api/maps/search/get-geocoding#uri-parameters).
|
|
761
|
-
*
|
|
762
|
-
*
|
|
763
|
-
* The batch should contain at least **1** query.
|
|
764
|
-
*
|
|
765
|
-
*
|
|
766
|
-
* ### Batch Response Model
|
|
767
|
-
* The batch response contains a `summary` component that indicates the `totalRequests` that were part of the original batch request and `successfulRequests` i.e. queries which were executed successfully. The batch response also includes a `batchItems` array which contains a response for each and every query in the batch request. The `batchItems` will contain the results in the exact same order the original queries were sent in the batch request. Each item is of one of the following types:
|
|
768
|
-
*
|
|
769
|
-
* - [`GeocodingResponse`](/rest/api/maps/search/get-geocoding#geocodingresponse) - If the query completed successfully.
|
|
770
|
-
*
|
|
771
|
-
* - `Error` - If the query failed. The response will contain a `code` and a `message` in this case.
|
|
772
|
-
*
|
|
773
|
-
*
|
|
774
|
-
*
|
|
775
|
-
*/
|
|
776
|
-
export declare interface SearchGetGeocodingBatchDefaultResponse extends HttpResponse {
|
|
777
|
-
status: string;
|
|
778
|
-
body: ErrorResponseOutput;
|
|
779
|
-
}
|
|
780
|
-
|
|
781
|
-
export declare interface SearchGetGeocodingBatchMediaTypesParam {
|
|
782
|
-
/** Request content type */
|
|
783
|
-
contentType?: "application/json";
|
|
784
|
-
}
|
|
785
|
-
|
|
786
|
-
export declare type SearchGetGeocodingBatchParameters = SearchGetGeocodingBatchMediaTypesParam & SearchGetGeocodingBatchBodyParam & RequestParameters;
|
|
787
|
-
|
|
788
|
-
/**
|
|
789
|
-
*
|
|
790
|
-
* The `Get Geocoding` API is an HTTP `GET` request that returns the longitude and latitude coordinates of the location being searched.
|
|
791
|
-
*
|
|
792
|
-
* In many cases, the complete search service might be too much, for instance if you are only interested in traditional geocoding. Search can also be accessed for address look up exclusively. The geocoding is performed by hitting the geocoding endpoint with just the address or partial address in question. The geocoding search index will be queried for everything above the street level data. No Point of Interest (POIs) will be returned. Note that the geocoder is very tolerant of typos and incomplete addresses. It will also handle everything from exact street addresses or street or intersections as well as higher level geographies such as city centers, counties and states. The response also returns detailed address properties such as street, postal code, municipality, and country/region information.
|
|
793
|
-
*/
|
|
794
|
-
export declare interface SearchGetGeocodingDefaultResponse extends HttpResponse {
|
|
795
|
-
status: string;
|
|
796
|
-
body: ErrorResponseOutput;
|
|
797
|
-
}
|
|
798
|
-
|
|
799
|
-
export declare type SearchGetGeocodingParameters = SearchGetGeocodingQueryParam & RequestParameters;
|
|
800
|
-
|
|
801
|
-
export declare interface SearchGetGeocodingQueryParam {
|
|
802
|
-
queryParameters?: SearchGetGeocodingQueryParamProperties;
|
|
803
|
-
}
|
|
804
|
-
|
|
805
|
-
export declare interface SearchGetGeocodingQueryParamProperties {
|
|
806
|
-
/** Maximum number of responses that will be returned. Default: 5, minimum: 1 and maximum: 20. */
|
|
807
|
-
top?: number;
|
|
808
|
-
/** A string that contains information about a location, such as an address or landmark name. */
|
|
809
|
-
query?: string;
|
|
810
|
-
/**
|
|
811
|
-
* The official street line of an address relative to the area, as specified by the locality, or postalCode, properties. Typical use of this element would be to provide a street address or any official address.
|
|
812
|
-
*
|
|
813
|
-
* **If query is given, should not use this parameter.**
|
|
814
|
-
*/
|
|
815
|
-
addressLine?: string;
|
|
816
|
-
/**
|
|
817
|
-
* Signal for the geocoding result to an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) that is specified e.g. FR./
|
|
818
|
-
*
|
|
819
|
-
* **If query is given, should not use this parameter.**
|
|
820
|
-
*/
|
|
821
|
-
countryRegion?: string;
|
|
822
|
-
/**
|
|
823
|
-
* A rectangular area on the earth defined as a bounding box object. The sides of the rectangles are defined by longitude and latitude values. When you specify this parameter, the geographical area is taken into account when computing the results of a location query.
|
|
824
|
-
*
|
|
825
|
-
* Example: lon1,lat1,lon2,lat2
|
|
826
|
-
*/
|
|
827
|
-
bbox?: Array<number>;
|
|
828
|
-
/**
|
|
829
|
-
* A string that represents an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). This will alter Geopolitical disputed borders and labels to align with the specified user region. By default, the View parameter is set to “Auto” even if you haven’t defined it in the request.
|
|
830
|
-
*
|
|
831
|
-
* Please refer to [Supported Views](https://aka.ms/AzureMapsLocalizationViews) for details and to see the available Views.
|
|
832
|
-
*/
|
|
833
|
-
view?: string;
|
|
834
|
-
/** A point on the earth specified as a longitude and latitude. When you specify this parameter, the user’s location is taken into account and the results returned may be more relevant to the user. Example: &coordinates=lon,lat */
|
|
835
|
-
coordinates?: Array<number>;
|
|
836
|
-
/**
|
|
837
|
-
* The country subdivision portion of an address, such as WA.
|
|
838
|
-
*
|
|
839
|
-
* **If query is given, should not use this parameter.**
|
|
840
|
-
*/
|
|
841
|
-
adminDistrict?: string;
|
|
842
|
-
/**
|
|
843
|
-
* The county for the structured address, such as King.
|
|
844
|
-
*
|
|
845
|
-
* **If query is given, should not use this parameter.**
|
|
846
|
-
*/
|
|
847
|
-
adminDistrict2?: string;
|
|
848
|
-
/**
|
|
849
|
-
* The named area for the structured address.
|
|
850
|
-
*
|
|
851
|
-
* **If query is given, should not use this parameter.**
|
|
852
|
-
*/
|
|
853
|
-
adminDistrict3?: string;
|
|
854
|
-
/**
|
|
855
|
-
* The locality portion of an address, such as Seattle.
|
|
856
|
-
*
|
|
857
|
-
* **If query is given, should not use this parameter.**
|
|
858
|
-
*/
|
|
859
|
-
locality?: string;
|
|
860
|
-
/**
|
|
861
|
-
* The postal code portion of an address.
|
|
862
|
-
*
|
|
863
|
-
* **If query is given, should not use this parameter.**
|
|
864
|
-
*/
|
|
865
|
-
postalCode?: string;
|
|
866
|
-
}
|
|
867
|
-
|
|
868
|
-
/**
|
|
869
|
-
*
|
|
870
|
-
* The `Get Polygon` API is an HTTP `GET` request that supplies polygon data of a geographical area outline such as a city or a country region.
|
|
871
|
-
*/
|
|
872
|
-
export declare interface SearchGetPolygon200Response extends HttpResponse {
|
|
873
|
-
status: "200";
|
|
874
|
-
body: BoundaryOutput;
|
|
875
|
-
}
|
|
876
|
-
|
|
877
|
-
/**
|
|
878
|
-
*
|
|
879
|
-
* The `Get Polygon` API is an HTTP `GET` request that supplies polygon data of a geographical area outline such as a city or a country region.
|
|
880
|
-
*/
|
|
881
|
-
export declare interface SearchGetPolygonDefaultResponse extends HttpResponse {
|
|
882
|
-
status: string;
|
|
883
|
-
body: ErrorResponseOutput;
|
|
884
|
-
}
|
|
885
|
-
|
|
886
|
-
export declare type SearchGetPolygonParameters = SearchGetPolygonQueryParam & RequestParameters;
|
|
887
|
-
|
|
888
|
-
export declare interface SearchGetPolygonQueryParam {
|
|
889
|
-
queryParameters: SearchGetPolygonQueryParamProperties;
|
|
890
|
-
}
|
|
891
|
-
|
|
892
|
-
export declare interface SearchGetPolygonQueryParamProperties {
|
|
893
|
-
/** A point on the earth specified as a longitude and latitude. Example: &coordinates=lon,lat */
|
|
894
|
-
coordinates: Array<number>;
|
|
895
|
-
/**
|
|
896
|
-
* A string that represents an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). This will alter Geopolitical disputed borders and labels to align with the specified user region. By default, the View parameter is set to “Auto” even if you haven’t defined it in the request.
|
|
897
|
-
*
|
|
898
|
-
* Please refer to [Supported Views](https://aka.ms/AzureMapsLocalizationViews) for details and to see the available Views.
|
|
899
|
-
*/
|
|
900
|
-
view?: string;
|
|
901
|
-
/** The geopolitical concept to return a boundary for. If not specified, the default is `countryRegion` result type. */
|
|
902
|
-
resultType?: "countryRegion" | "adminDistrict" | "adminDistrict2" | "postalCode" | "postalCode2" | "postalCode3" | "postalCode4" | "neighborhood" | "locality";
|
|
903
|
-
/** Resolution determines the amount of points to send back. If not specified, the default is medium resolution. */
|
|
904
|
-
resolution?: "small" | "medium" | "large" | "huge";
|
|
905
|
-
}
|
|
906
|
-
|
|
907
|
-
/**
|
|
908
|
-
*
|
|
909
|
-
* The `Get Reverse Geocoding` API is an HTTP `GET` request used to translate a coordinate (example: 37.786505, -122.3862) into a human understandable street address. Useful in tracking applications where you receive a GPS feed from the device or asset and wish to know the address associated with the coordinates. This endpoint will return address information for a given coordinate.
|
|
910
|
-
*/
|
|
911
|
-
export declare interface SearchGetReverseGeocoding200Response extends HttpResponse {
|
|
912
|
-
status: "200";
|
|
913
|
-
body: GeocodingResponseOutput;
|
|
914
|
-
}
|
|
915
|
-
|
|
916
|
-
/**
|
|
917
|
-
*
|
|
918
|
-
* The `Get Reverse Geocoding Batch` API is an HTTP `POST` request that sends batches of up to **100** queries to [Reverse Geocoding](/rest/api/maps/search/get-reverse-geocoding) API using a single request.
|
|
919
|
-
*
|
|
920
|
-
* ### Submit Synchronous Batch Request
|
|
921
|
-
* The Synchronous API is recommended for lightweight batch requests. When the service receives a request, it will respond as soon as the batch items are calculated and there will be no possibility to retrieve the results later. The Synchronous API will return a timeout error (a 408 response) if the request takes longer than 60 seconds. The number of batch items is limited to **100** for this API.
|
|
922
|
-
* ```
|
|
923
|
-
* POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01
|
|
924
|
-
* ```
|
|
925
|
-
* ### POST Body for Batch Request
|
|
926
|
-
* To send the _reverse geocoding_ queries you will use a `POST` request where the request body will contain the `batchItems` array in `json` format and the `Content-Type` header will be set to `application/json`. Here's a sample request body containing 2 _reverse geocoding_ queries:
|
|
927
|
-
*
|
|
928
|
-
*
|
|
929
|
-
* ```
|
|
930
|
-
* {
|
|
931
|
-
* "batchItems": [
|
|
932
|
-
* {
|
|
933
|
-
* "coordinates": [-122.128275, 47.639429],
|
|
934
|
-
* "resultTypes": ["Address", "PopulatedPlace"]
|
|
935
|
-
* },
|
|
936
|
-
* {
|
|
937
|
-
* "coordinates": [-122.341979399674, 47.6095253501216]
|
|
938
|
-
* }
|
|
939
|
-
* ]
|
|
940
|
-
* }
|
|
941
|
-
* ```
|
|
942
|
-
*
|
|
943
|
-
* A _reverse geocoding_ batchItem object can accept any of the supported _reverse geocoding_ [URI parameters](/rest/api/maps/search/get-reverse-geocoding#uri-parameters).
|
|
944
|
-
*
|
|
945
|
-
*
|
|
946
|
-
* The batch should contain at least **1** query.
|
|
947
|
-
*
|
|
948
|
-
*
|
|
949
|
-
* ### Batch Response Model
|
|
950
|
-
* The batch response contains a `summary` component that indicates the `totalRequests` that were part of the original batch request and `successfulRequests` i.e. queries which were executed successfully. The batch response also includes a `batchItems` array which contains a response for each and every query in the batch request. The `batchItems` will contain the results in the exact same order the original queries were sent in the batch request. Each item is of one of the following types:
|
|
951
|
-
*
|
|
952
|
-
* - [`GeocodingResponse`](/rest/api/maps/search/get-reverse-geocoding#geocodingresponse) - If the query completed successfully.
|
|
953
|
-
*
|
|
954
|
-
* - `Error` - If the query failed. The response will contain a `code` and a `message` in this case.
|
|
955
|
-
*
|
|
956
|
-
*
|
|
957
|
-
*
|
|
958
|
-
*/
|
|
959
|
-
export declare interface SearchGetReverseGeocodingBatch200Response extends HttpResponse {
|
|
960
|
-
status: "200";
|
|
961
|
-
body: GeocodingBatchResponseOutput;
|
|
962
|
-
}
|
|
963
|
-
|
|
964
|
-
export declare interface SearchGetReverseGeocodingBatchBodyParam {
|
|
965
|
-
/** The list of reverse geocoding queries/requests to process. The list can contain a max of 100 queries and must contain at least 1 query. */
|
|
966
|
-
body: ReverseGeocodingBatchRequestBody;
|
|
967
|
-
}
|
|
968
|
-
|
|
969
|
-
/**
|
|
970
|
-
*
|
|
971
|
-
* The `Get Reverse Geocoding Batch` API is an HTTP `POST` request that sends batches of up to **100** queries to [Reverse Geocoding](/rest/api/maps/search/get-reverse-geocoding) API using a single request.
|
|
972
|
-
*
|
|
973
|
-
* ### Submit Synchronous Batch Request
|
|
974
|
-
* The Synchronous API is recommended for lightweight batch requests. When the service receives a request, it will respond as soon as the batch items are calculated and there will be no possibility to retrieve the results later. The Synchronous API will return a timeout error (a 408 response) if the request takes longer than 60 seconds. The number of batch items is limited to **100** for this API.
|
|
975
|
-
* ```
|
|
976
|
-
* POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01
|
|
977
|
-
* ```
|
|
978
|
-
* ### POST Body for Batch Request
|
|
979
|
-
* To send the _reverse geocoding_ queries you will use a `POST` request where the request body will contain the `batchItems` array in `json` format and the `Content-Type` header will be set to `application/json`. Here's a sample request body containing 2 _reverse geocoding_ queries:
|
|
980
|
-
*
|
|
981
|
-
*
|
|
982
|
-
* ```
|
|
983
|
-
* {
|
|
984
|
-
* "batchItems": [
|
|
985
|
-
* {
|
|
986
|
-
* "coordinates": [-122.128275, 47.639429],
|
|
987
|
-
* "resultTypes": ["Address", "PopulatedPlace"]
|
|
988
|
-
* },
|
|
989
|
-
* {
|
|
990
|
-
* "coordinates": [-122.341979399674, 47.6095253501216]
|
|
991
|
-
* }
|
|
992
|
-
* ]
|
|
993
|
-
* }
|
|
994
|
-
* ```
|
|
995
|
-
*
|
|
996
|
-
* A _reverse geocoding_ batchItem object can accept any of the supported _reverse geocoding_ [URI parameters](/rest/api/maps/search/get-reverse-geocoding#uri-parameters).
|
|
997
|
-
*
|
|
998
|
-
*
|
|
999
|
-
* The batch should contain at least **1** query.
|
|
1000
|
-
*
|
|
1001
|
-
*
|
|
1002
|
-
* ### Batch Response Model
|
|
1003
|
-
* The batch response contains a `summary` component that indicates the `totalRequests` that were part of the original batch request and `successfulRequests` i.e. queries which were executed successfully. The batch response also includes a `batchItems` array which contains a response for each and every query in the batch request. The `batchItems` will contain the results in the exact same order the original queries were sent in the batch request. Each item is of one of the following types:
|
|
1004
|
-
*
|
|
1005
|
-
* - [`GeocodingResponse`](/rest/api/maps/search/get-reverse-geocoding#geocodingresponse) - If the query completed successfully.
|
|
1006
|
-
*
|
|
1007
|
-
* - `Error` - If the query failed. The response will contain a `code` and a `message` in this case.
|
|
1008
|
-
*
|
|
1009
|
-
*
|
|
1010
|
-
*
|
|
1011
|
-
*/
|
|
1012
|
-
export declare interface SearchGetReverseGeocodingBatchDefaultResponse extends HttpResponse {
|
|
1013
|
-
status: string;
|
|
1014
|
-
body: ErrorResponseOutput;
|
|
1015
|
-
}
|
|
1016
|
-
|
|
1017
|
-
export declare interface SearchGetReverseGeocodingBatchMediaTypesParam {
|
|
1018
|
-
/** Request content type */
|
|
1019
|
-
contentType?: "application/json";
|
|
1020
|
-
}
|
|
1021
|
-
|
|
1022
|
-
export declare type SearchGetReverseGeocodingBatchParameters = SearchGetReverseGeocodingBatchMediaTypesParam & SearchGetReverseGeocodingBatchBodyParam & RequestParameters;
|
|
1023
|
-
|
|
1024
|
-
/**
|
|
1025
|
-
*
|
|
1026
|
-
* The `Get Reverse Geocoding` API is an HTTP `GET` request used to translate a coordinate (example: 37.786505, -122.3862) into a human understandable street address. Useful in tracking applications where you receive a GPS feed from the device or asset and wish to know the address associated with the coordinates. This endpoint will return address information for a given coordinate.
|
|
1027
|
-
*/
|
|
1028
|
-
export declare interface SearchGetReverseGeocodingDefaultResponse extends HttpResponse {
|
|
1029
|
-
status: string;
|
|
1030
|
-
body: ErrorResponseOutput;
|
|
1031
|
-
}
|
|
1032
|
-
|
|
1033
|
-
export declare type SearchGetReverseGeocodingParameters = SearchGetReverseGeocodingQueryParam & RequestParameters;
|
|
1034
|
-
|
|
1035
|
-
export declare interface SearchGetReverseGeocodingQueryParam {
|
|
1036
|
-
queryParameters: SearchGetReverseGeocodingQueryParamProperties;
|
|
1037
|
-
}
|
|
1038
|
-
|
|
1039
|
-
export declare interface SearchGetReverseGeocodingQueryParamProperties {
|
|
1040
|
-
/** The coordinates of the location that you want to reverse geocode. Example: &coordinates=lon,lat */
|
|
1041
|
-
coordinates: Array<number>;
|
|
1042
|
-
/**
|
|
1043
|
-
* Specify entity types that you want in the response. Only the types you specify will be returned. If the point cannot be mapped to the entity types you specify, no location information is returned in the response.
|
|
1044
|
-
* Default value is all possible entities.
|
|
1045
|
-
* A comma separated list of entity types selected from the following options.
|
|
1046
|
-
*
|
|
1047
|
-
* - Address
|
|
1048
|
-
* - Neighborhood
|
|
1049
|
-
* - PopulatedPlace
|
|
1050
|
-
* - Postcode1
|
|
1051
|
-
* - AdminDivision1
|
|
1052
|
-
* - AdminDivision2
|
|
1053
|
-
* - CountryRegion
|
|
1054
|
-
*
|
|
1055
|
-
* These entity types are ordered from the most specific entity to the least specific entity. When entities of more than one entity type are found, only the most specific entity is returned. For example, if you specify Address and AdminDistrict1 as entity types and entities were found for both types, only the Address entity information is returned in the response.
|
|
1056
|
-
*/
|
|
1057
|
-
resultTypes?: Array<"Address" | "Neighborhood" | "PopulatedPlace" | "Postcode1" | "AdminDivision1" | "AdminDivision2" | "CountryRegion">;
|
|
1058
|
-
/**
|
|
1059
|
-
* A string that represents an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). This will alter Geopolitical disputed borders and labels to align with the specified user region. By default, the View parameter is set to “Auto” even if you haven’t defined it in the request.
|
|
1060
|
-
*
|
|
1061
|
-
* Please refer to [Supported Views](https://aka.ms/AzureMapsLocalizationViews) for details and to see the available Views.
|
|
1062
|
-
*/
|
|
1063
|
-
view?: string;
|
|
1064
|
-
}
|
|
1065
|
-
|
|
1066
|
-
export { }
|