Khái niệm nâng cao

Đang thu thập dữ liệu

Có nhiều cách để lấy dữ liệu vị trí đã thu thập. Ở đây, chúng tôi mô tả 2 kỹ thuật thu thập dữ liệu để sử dụng với tính năng snap totrình duyệt của Roads API.

GPX

GPX là một định dạng mở dựa trên XML để chia sẻ các tuyến đường, đường đi và điểm tham chiếu được thiết bị GPS thu thập. Ví dụ này sử dụng trình phân tích cú pháp XmlPull, một trình phân tích cú pháp XML nhẹ có sẵn cho cả môi trường máy chủ Java và thiết bị di động.

/**
 * 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;
}

Đây là một số dữ liệu GPX thô được tải lên bản đồ.

Dịch vụ vị trí của Android

Cách tốt nhất để thu thập dữ liệu GPS từ thiết bị Android sẽ khác nhau tuỳ thuộc vào trường hợp sử dụng của bạn. Hãy xem lớp đào tạo về Android về Nhận thông tin cập nhật vị trí, cũng như mẫu Thông tin vị trí trên Google Play trên GitHub.

Xử lý đường dẫn dài

Vì tính năng bám theo đường suy ra vị trí dựa trên đường dẫn đầy đủ, thay vì từng điểm riêng lẻ, bạn cần cẩn thận khi xử lý các đường dẫn dài (tức là các đường dẫn vượt quá giới hạn 100 điểm cho mỗi yêu cầu).

Để coi các yêu cầu riêng lẻ là một đường dẫn dài, bạn nên bao gồm một số phần trùng lặp, sao cho các điểm cuối cùng của yêu cầu trước được đưa vào dưới dạng điểm đầu tiên của yêu cầu tiếp theo. Số điểm cần đưa vào sẽ tuỳ thuộc vào độ chính xác của dữ liệu. Bạn nên thêm nhiều điểm cho các yêu cầu có độ chính xác thấp.

Ví dụ này sử dụng Ứng dụng Java cho Dịch vụ Google Maps để gửi các yêu cầu được phân trang, sau đó tham gia lại dữ liệu (bao gồm cả các điểm nội suy) vào danh sách được trả về.

/**
 * 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;
}

Đây là dữ liệu ở trên sau khi chạy ảnh chụp nhanh yêu cầu về đường. Đường màu đỏ là dữ liệu thô và đường màu xanh dương là dữ liệu chụp nhanh.

Sử dụng hạn mức hiệu quả

Phản hồi cho yêu cầu liên kết nhanh theo đường bao gồm danh sách mã địa điểm liên kết với các điểm bạn đã cung cấp, có thể có thêm các điểm nếu bạn đặt interpolate=true.

Để sử dụng hiệu quả hạn mức được phép cho yêu cầu giới hạn tốc độ, bạn chỉ nên truy vấn mã địa điểm duy nhất trong yêu cầu của mình. Ví dụ này sử dụng Ứng dụng Java cho Dịch vụ Google Maps để truy vấn giới hạn tốc độ từ danh sách mã địa điểm.

/**
 * 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;
}

Đây là dữ liệu ở trên với giới hạn tốc độ được đánh dấu tại từng mã địa điểm duy nhất.

Tương tác với các API khác

Một trong những lợi ích của việc trả về mã địa điểm trong các phản hồi liên kết nhanh theo đường là bạn có thể sử dụng mã địa điểm trên nhiều API Nền tảng Google Maps. Ví dụ này sử dụng Ứng dụng Java cho Dịch vụ Google Maps để mã hoá địa lý một địa điểm được trả về từ lệnh yêu cầu đường đi ở trên.

/**
 * 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;
}

Ở đây, điểm đánh dấu giới hạn tốc độ được chú thích bằng địa chỉ từ API mã hoá địa lý.

Mã mẫu

Những yếu tố nên cân nhắc

Mã hỗ trợ bài viết này được cung cấp dưới dạng một ứng dụng Android duy nhất cho mục đích minh hoạ. Trên thực tế, bạn không nên phân phối khoá API phía máy chủ trong ứng dụng Android vì bên thứ ba không thể bảo vệ khoá của bạn khỏi hoạt động truy cập trái phép. Thay vào đó, để bảo mật các khoá, bạn nên triển khai mã dành cho API dưới dạng proxy phía máy chủ và yêu cầu ứng dụng Android gửi các yêu cầu qua proxy, đảm bảo các yêu cầu đã được uỷ quyền.

Tải xuống

Tải mã nguồn xuống từ GitHub.