Roads API फ़ंक्शन में ज़्यादा से ज़्यादा 100 अलग-अलग निर्देशांक डाले जा सकते हैं. साथ ही, यह हर पॉइंट के लिए सड़क का सबसे नज़दीकी सेगमेंट दिखाता है. यह ज़रूरी नहीं है कि पास किए गए पॉइंट, एक ही रास्ते के हिस्से हों.
अगर आपको क्रम से मौजूद जीपीएस पॉइंट का इस्तेमाल करना है, तो सड़कों पर स्नैप करें सुविधा का इस्तेमाल करें.
अनुरोध
आस-पास की सड़कों के बारे में अनुरोध, एचटीटीपीएस के ज़रिए भेजा जाना चाहिए. यह अनुरोध इस तरह का होता है:
https://roads.googleapis.com/v1/nearestRoads?parameters&key=YOUR_API_KEY
Required parameters
points
The points to be snapped. The points parameter accepts a list of latitude/longitude pairs. Separate latitude and longitude values with commas. Separate coordinates with the pipe character: "|". For example:
points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
उदाहरण
नीचे दिया गया अनुरोध, निर्देशांक की तय सूची के आधार पर सड़क के सेगमेंट का एक सेट दिखाता है.
URL
https://roads.googleapis.com/v1/nearestRoads ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796 &key=YOUR_API_KEY
cURL
curl -L -X GET 'https://roads.googleapis.com/v1/nearestRoads?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796&key=YOUR_API_KEY'
जवाब
हर मान्य अनुरोध के लिए, Roads API अनुरोध यूआरएल में बताए गए फ़ॉर्मैट में जवाब देगा.
{ "snappedPoints": [ { "location": { "latitude": 60.170878428876755, "longitude": 24.94269540970182 }, "originalIndex": 0, "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w", }, { "location": { "latitude": 60.17087741412199, "longitude": 24.942695474405202 }, "originalIndex": 1, "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w", }, { "location": { "latitude": 60.170875416131736, "longitude": 24.942695601802203 }, "originalIndex": 2, "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w", }, ], }
रिस्पॉन्स में, नीचे दिए गए स्कीमा का इस्तेमाल किया जाता है.
NearestRoadsResponse
| Field | Required | Type | Description |
|---|---|---|---|
| optional | Array<SnappedPoint> | An array of snapped points. Sometimes containing several snapped points for the same point with differing placeId or location. See SnappedPoint for more information. |
SnappedPoint
| Field | Required | Type | Description |
|---|---|---|---|
| required | LatitudeLongitudeLiteral | See LatitudeLongitudeLiteral for more information. |
| required | string | A unique identifier for a place. All place IDs returned by the Roads API correspond to road segments. |
| optional | number |
An integer that indicates the corresponding value in the original
request. Each value in the request should map to a snapped value in
the response. However, if you've set interpolate=true or if you're
using nearest roads, then it's possible that the response will
contain more coordinates than the request. Interpolated values will
not have an |
LatitudeLongitudeLiteral
An object describing a specific location with Latitude and Longitude in decimal degrees.
| Field | Required | Type | Description |
|---|---|---|---|
| required | number | Latitude in decimal degrees |
| required | number | Longitude in decimal degrees |