Khái niệm nâng cao

Đang nhận dữ liệu

Có nhiều cách để có được dữ liệu vị trí đã thu thập. Ở đây, chúng tôi mô tả hai các kỹ thuật thu thập dữ liệu để sử dụng bằng tính năng gắn liền với đường của Roads API.

GPX

GPX là định dạng dựa trên XML mở để chia sẻ các tuyến đường, tuyến đường và điểm tham chiếu được chụp bởi thiết bị GPS. Ví dụ này sử dụng trình phân tích cú pháp XmlPull, Trình phân tích cú pháp XML gọn nhẹ dùng được cho cả máy chủ Java và môi trường 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;
}

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

Dữ liệu GPX thô trên bản đồ

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

Cách tốt nhất để chụp dữ liệu GPS từ thiết bị Android thay đổi tuỳ theo trường hợp sử dụng. Hãy xem lớp đào tạo của Android về Nhận thông tin vị trí Bản cập nhật, cũng như Mẫu 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 luận vị trí dựa trên đường đi đầy đủ, thay vì các điểm riêng lẻ, bạn cần phải cẩn trọng khi xử lý thời gian dài đường dẫn (tức là đườ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 thêm một số điểm trùng lặp, chẳng hạn như các điểm cuối cùng của yêu cầu trước được đưa vào làm điểm đầu tiên của yêu cầu tiếp theo. Số điểm cần đưa vào phụ thuộc vào độ chính xác của dữ liệu. Bạn nên thêm nhiều điểm hơn 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 dành cho Dịch vụ Google Maps để gửi yêu cầu được phân trang và sau đó tham gia lại dữ liệu, kể 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;
}

Dưới đây là dữ liệu từ trên sau khi chạy các yêu cầu chụp nhanh đường. Màu đỏ dòng là dữ liệu thô và đường màu xanh dương là dữ liệu được chụp nhanh.

Ví dụ về dữ liệu đã được nối với đường

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

Phản hồi cho yêu cầu bám đường sẽ bao gồm một danh sách mã địa điểm tương ứng với các điểm bạn đã cung cấp, có thể kèm thêm đ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 các 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 dành cho Dịch vụ Google Maps để truy vấn giới hạn tốc độ từ một danh sách địa điểm Mã nhận dạng.

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

Dưới đây là dữ liệu ở trên, trong đó có giới hạn tốc độ được đánh dấu tại mỗi mã địa điểm duy nhất.

Biển báo giới hạn tốc độ trên bản đồ

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

Một trong những lợi ích của việc trả lại mã địa điểm trong tính năng nắm bắt đường của bạn là bạn có thể sử dụng mã địa điểm trên nhiều API của 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ừ yêu cầu đường từ ảnh chụp nhanh ở 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;
}

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

Địa chỉ được mã hoá địa lý hiển thị trên điểm đánh dấu

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 phía máy chủ Khoá API trong một ứng dụng Android vì không thể bảo vệ khoá của bạn bằng các khoá trái phép quyền truy cập của một bên thứ ba. Thay vào đó, để bảo mật khoá, bạn nên triển khai mã giao diện API dưới dạng proxy phía máy chủ và yêu cầu ứng dụng Android gửi yêu cầu thông 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.