তথ্য অর্জন
সংগৃহীত অবস্থান তথ্য প্রাপ্ত করার অনেক উপায় আছে. এখানে আমরা Roads API -এর স্ন্যাপ টু রোড বৈশিষ্ট্যের সাথে ব্যবহার করার জন্য ডেটা অর্জনের দুটি কৌশল বর্ণনা করি।
জিপিএক্স
জিপিএক্স হল একটি খোলা XML-ভিত্তিক বিন্যাস যা জিপিএস ডিভাইস দ্বারা ক্যাপচার করা রুট, ট্র্যাক এবং ওয়েপয়েন্ট শেয়ার করার জন্য। এই উদাহরণটি XmlPull পার্সার ব্যবহার করে, একটি হালকা ওজনের XML পার্সার যা জাভা সার্ভার এবং মোবাইল উভয় পরিবেশের জন্য উপলব্ধ।
/**
* Parses the waypoint (wpt tags) data into native objects from a GPX stream.
*/
private List<LatLng> loadGpxData(XmlPullParser parser, InputStream gpxIn)
throws XmlPullParserException, IOException {
// We use a List<> as we need subList for paging later
List<LatLng> latLngs = new ArrayList<>();
parser.setInput(gpxIn, null);
parser.nextTag();
while (parser.next() != XmlPullParser.END_DOCUMENT) {
if (parser.getEventType() != XmlPullParser.START_TAG) {
continue;
}
if (parser.getName().equals("wpt")) {
// Save the discovered latitude/longitude attributes in each <wpt>.
latLngs.add(new LatLng(
Double.valueOf(parser.getAttributeValue(null, "lat")),
Double.valueOf(parser.getAttributeValue(null, "lon"))));
}
// Otherwise, skip irrelevant data
}
return latLngs;
}
এখানে কিছু কাঁচা GPX ডেটা একটি মানচিত্রে লোড করা হয়েছে৷
অ্যান্ড্রয়েড অবস্থান পরিষেবা
একটি Android ডিভাইস থেকে GPS ডেটা ক্যাপচার করার সর্বোত্তম উপায় আপনার ব্যবহারের ক্ষেত্রে নির্ভর করে। GitHub-এ অবস্থানের আপডেট প্রাপ্তির Android প্রশিক্ষণ ক্লাসের পাশাপাশি Google Play অবস্থানের নমুনাগুলি দেখুন।
দীর্ঘ পথ প্রক্রিয়াকরণ
যেহেতু স্ন্যাপ টু রোড ফিচারটি পৃথক পয়েন্টের পরিবর্তে সম্পূর্ণ পথের উপর ভিত্তি করে অবস্থান নির্ণয় করে, তাই দীর্ঘ পথ প্রক্রিয়াকরণের সময় আপনাকে সতর্কতা অবলম্বন করতে হবে (অর্থাৎ, 100-পয়েন্ট-প্রতি-অনুরোধের সীমার উপরে পাথ)।
পৃথক অনুরোধগুলিকে একটি দীর্ঘ পথ হিসাবে বিবেচনা করার জন্য, আপনার কিছু ওভারল্যাপ অন্তর্ভুক্ত করা উচিত, যেমন পূর্ববর্তী অনুরোধের চূড়ান্ত পয়েন্টগুলি পরবর্তী অনুরোধের প্রথম পয়েন্ট হিসাবে অন্তর্ভুক্ত করা হয়। পয়েন্টের সংখ্যা আপনার ডেটার নির্ভুলতার উপর নির্ভর করে। কম-নির্ভুলতার অনুরোধের জন্য আপনার আরও পয়েন্ট অন্তর্ভুক্ত করা উচিত।
এই উদাহরণটি Google মানচিত্র পরিষেবাগুলির জন্য জাভা ক্লায়েন্ট ব্যবহার করে পৃষ্ঠাযুক্ত অনুরোধগুলি পাঠায় এবং তারপরে প্রত্যাবর্তিত তালিকায় ইন্টারপোলেটেড পয়েন্ট সহ ডেটা পুনরায় যোগ দেয়।
/**
* Snaps the points to their most likely position on roads using the Roads API.
*/
private List<SnappedPoint> snapToRoads(GeoApiContext context) throws Exception {
List<SnappedPoint> snappedPoints = new ArrayList<>();
int offset = 0;
while (offset < mCapturedLocations.size()) {
// Calculate which points to include in this request. We can't exceed the API's
// maximum and we want to ensure some overlap so the API can infer a good location for
// the first few points in each request.
if (offset > 0) {
offset -= PAGINATION_OVERLAP; // Rewind to include some previous points.
}
int lowerBound = offset;
int upperBound = Math.min(offset + PAGE_SIZE_LIMIT, mCapturedLocations.size());
// Get the data we need for this page.
LatLng[] page = mCapturedLocations
.subList(lowerBound, upperBound)
.toArray(new LatLng[upperBound - lowerBound]);
// Perform the request. Because we have interpolate=true, we will get extra data points
// between our originally requested path. To ensure we can concatenate these points, we
// only start adding once we've hit the first new point (that is, skip the overlap).
SnappedPoint[] points = RoadsApi.snapToRoads(context, true, page).await();
boolean passedOverlap = false;
for (SnappedPoint point : points) {
if (offset == 0 || point.originalIndex >= PAGINATION_OVERLAP - 1) {
passedOverlap = true;
}
if (passedOverlap) {
snappedPoints.add(point);
}
}
offset = upperBound;
}
return snappedPoints;
}
রাস্তার অনুরোধে স্ন্যাপ চালানোর পরে উপরে থেকে ডেটা এখানে। লাল রেখা হল কাঁচা ডেটা এবং নীল রেখা হল স্ন্যাপ করা ডেটা।
কোটার দক্ষ ব্যবহার
রাস্তার অনুরোধের একটি স্ন্যাপের প্রতিক্রিয়াতে স্থানের আইডিগুলির একটি তালিকা অন্তর্ভুক্ত রয়েছে যা আপনার দেওয়া পয়েন্টগুলিতে ম্যাপ করে, সম্ভাব্যভাবে অতিরিক্ত পয়েন্ট সহ যদি আপনি interpolate=true সেট করেন।
গতি সীমার অনুরোধের জন্য আপনার অনুমোদিত কোটার দক্ষ ব্যবহার করার জন্য, আপনার অনুরোধে শুধুমাত্র অনন্য স্থান আইডির জন্য অনুসন্ধান করা উচিত। এই উদাহরণটি Google মানচিত্র পরিষেবাগুলির জন্য জাভা ক্লায়েন্ট ব্যবহার করে স্থান আইডিগুলির একটি তালিকা থেকে গতি সীমা অনুসন্ধান করতে।
/**
* Retrieves speed limits for the previously-snapped points. This method is efficient in terms
* of quota usage as it will only query for unique places.
*
* Note: Speed limit data is only available for requests using an API key enabled for a
* Google Maps APIs Premium Plan license.
*/
private Map<String, SpeedLimit> getSpeedLimits(GeoApiContext context, List<SnappedPoint> points)
throws Exception {
Map<String, SpeedLimit> placeSpeeds = new HashMap<>();
// Pro tip: Save on quota by filtering to unique place IDs.
for (SnappedPoint point : points) {
placeSpeeds.put(point.placeId, null);
}
String[] uniquePlaceIds =
placeSpeeds.keySet().toArray(new String[placeSpeeds.keySet().size()]);
// Loop through the places, one page (API request) at a time.
for (int i = 0; i < uniquePlaceIds.length; i += PAGE_SIZE_LIMIT) {
String[] page = Arrays.copyOfRange(uniquePlaceIds, i,
Math.min(i + PAGE_SIZE_LIMIT, uniquePlaceIds.length));
// Execute!
SpeedLimit[] placeLimits = RoadsApi.speedLimits(context, page).await();
for (SpeedLimit sl : placeLimits) {
placeSpeeds.put(sl.placeId, sl);
}
}
return placeSpeeds;
}
প্রতিটি অনন্য স্থান আইডিতে চিহ্নিত গতি সীমা সহ উপরে থেকে ডেটা এখানে রয়েছে৷
অন্যান্য API এর সাথে ইন্টারপ্লে
স্ন্যাপ টু রোড রেসপন্সে প্লেস আইডি ফেরত পাওয়ার সুবিধাগুলির মধ্যে একটি হল যে আপনি Google ম্যাপ প্ল্যাটফর্ম API-এর অনেকগুলি জুড়ে প্লেস আইডি ব্যবহার করতে পারেন। এই উদাহরণটি Google মানচিত্র পরিষেবাগুলির জন্য জাভা ক্লায়েন্ট ব্যবহার করে উপরের স্ন্যাপ থেকে রাস্তার অনুরোধে ফিরে আসা একটি স্থানকে জিওকোড করতে।
/**
* Geocodes a snapped point using the place ID.
*/
private GeocodingResult geocodeSnappedPoint(GeoApiContext context, SnappedPoint point) throws Exception {
GeocodingResult[] results = GeocodingApi.newRequest(context)
.place(point.placeId)
.await();
if (results.length > 0) {
return results[0];
}
return null;
}
এখানে গতি সীমা চিহ্নিতকারী জিওকোডিং এপিআই থেকে ঠিকানা সহ টীকা করা হয়েছে।
কোডের উদাহরণ
বিবেচনা
এই নিবন্ধটিকে সমর্থনকারী কোডটি উদাহরণের উদ্দেশ্যে একটি একক Android অ্যাপ হিসাবে উপলব্ধ। অনুশীলনে আপনার সার্ভার-সাইড এপিআই কীগুলি একটি অ্যান্ড্রয়েড অ্যাপে বিতরণ করা উচিত নয় কারণ আপনার কী তৃতীয় পক্ষের অননুমোদিত অ্যাক্সেসের বিরুদ্ধে সুরক্ষিত করা যায় না। পরিবর্তে, আপনার কীগুলি সুরক্ষিত করার জন্য আপনাকে সার্ভার-সাইড প্রক্সি হিসাবে API-মুখী কোড স্থাপন করা উচিত এবং অনুরোধগুলি অনুমোদিত হয়েছে তা নিশ্চিত করে আপনার Android অ্যাপকে প্রক্সির মাধ্যমে অনুরোধ পাঠাতে হবে।
ডাউনলোড করুন
GitHub থেকে কোডটি ডাউনলোড করুন।