Khái niệm nâng cao

Lưu ý: Các ví dụ dưới đây sử dụng Roads API trong Ứng dụng Java cho Dịch vụ Google Maps. Bạn có thể điều chỉnh các khái niệm cho phù hợp với ngôn ngữ mình chọn. Ứng dụng Python, Go Client và Node.js Client cũng có trên GitHub.

Thu thập dữ liệu

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

GPX

GPX là một đị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 mà thiết bị GPS thu thập được. 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 gọn nhẹ có sẵn cho cả môi trường máy chủ Java và môi trường 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;
}

Dưới đâ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 còn tuỳ thuộc vào trường hợp sử dụng của bạn. Hãy xem lớp đào tạo Android về cách Nhận thông tin cập nhật vị trí, 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 định vị dọc theo đường suy luận vị trí dựa trên toàn bộ đường dẫn, thay vì các điểm riêng lẻ, nên 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 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 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;
}

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

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

Phản hồi cho yêu cầu định vị đường bao gồm danh sách mã nhận dạng đị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 về 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ã nhận dạng đị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;
}

Dưới đây là dữ liệu ở trên, trong đó giới hạn tốc độ được đánh dấu tại mỗi mã địa điểm riêng biệ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 gắn liền với đườ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ừ 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;
}

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

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ạ. Trong 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ì khoá của bạn không thể được bảo mật khỏi quyền truy cập trái phép của 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.