Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Maps Roads API

Untuk membantu Anda memulai, kami akan memandu Anda melalui Google Developers Console untuk melakukan beberapa hal terlebih dahulu:

  1. Buat atau pilih sebuah proyek
  2. Aktifkan Google Maps Roads API
  3. Buat kunci yang sesuai
Lanjutkan

Konsep Lanjutan

Catatan: Contoh-contoh di bawah ini menggunakan Google Maps Roads API di Java Client for Google Maps Services. Anda bisa mengadaptasikan konsep dengan bahasa yang Anda pilih. Python Client, Go Client dan Node.js Client juga tersedia di GitHub.

Memperoleh data

Ada banyak cara untuk memperoleh data lokasi yang terkumpul. Di sini kami menjelaskan dua teknik untuk memperoleh data yang akan digunakan bersama fitur snap to roads Google Maps Roads API.

GPX

GPX adalah format terbuka berbasis XML untuk berbagi rute, jalur dan titik jalan yang direkam oleh perangkat GPS. Contoh ini menggunakan parser XmlPull, sebuah parser XML ringan yang tersedia untuk server Java dan lingkungan seluler.

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

Inilah beberapa data GPX mentah yang dimuat ke peta.

Data GPX mentah pada peta

Layanan lokasi Android

Cara terbaik untuk merekam data GPS dari perangkat Android bervariasi bergantung pada kasus penggunaan Anda. Lihat kelas pelatihan Android tentang Menerima Pembaruan Lokasi, serta contoh Google Play Location di GitHub.

Memproses jalur yang panjang

Karena fitur snap to roads menduga lokasi berdasarkan jalur lengkap, bukan titik individual, Anda perlu berhati-hati saat memproses jalur yang panjang (yakni, jalur tersebut melebihi batas 100 titik per permintaan).

Agar bisa memperlakukan permintaan individual sebagai satu jalur panjang, Anda harus menyertakan beberapa tumpang tindih, asalkan titik akhir dari permintaan sebelumnya disertakan sebagai titik pertama dari permintaan berikutnya. Jumlah titik yang akan disertakan bergantung pada akurasi data Anda. Anda harus menyertakan titik lebih banyak untuk permintaan yang akurasinya rendah.

Contoh ini menggunakan Java Client for Google Maps Services untuk mengirim permintaan paged kemudian menggabungkan kembali data tersebut, termasuk titik interpolasi, ke dalam daftar yang dikembalikan.

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

Inilah data dari hal atas setelah menjalankan permintaan snap-to-road. Garis merah adalah data mentah dan garis biru adalah data yang diikat.

Contoh data yang telah diikat ke jalan

Penggunaan kuota yang efisien

Respons terhadap permintaan snap to roads menyertakan daftar ID tempat yang memetakan ke titik-titik yang Anda sediakan, kemungkinan bersama titik tambahan jika Anda menyetel interpolate=true.

Untuk mengefisienkan penggunaan kuota yang diperbolehkan bagi permintaan batas kecepatan, Anda hanya boleh membuat kueri untuk ID tempat unik dalam permintaan. Contoh ini menggunakan Java Client for Google Maps Services untuk membuat kueri batas kecepatan dari daftar ID tempat.

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

Inilah data dari contoh di atas dengan batas kecepatan yang ditandai pada setiap ID tempat yang unik.

Tanda batas kecepatan pada peta

Saling memengaruhi dengan API lainnya

Salah satu manfaat memiliki ID tempat yang dikembalikan di respons snap to roads adalah karena Anda bisa menggunakan ID tempat di semua Google Maps API. Contoh ini menggunakan Java Client for Google Maps Services untuk meng-geocode tempat yang dikembalikan dari permintaan snap-to-road di atas.

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

Di sini marker batas kecepatan dibubuhkan bersama alamat dari Google Maps Geocoding API.

Alamat Geocode yang ditampilkan pada marker

Kode contoh

Pertimbangan

Kode yang mendukung artikel ini tersedia sebagai aplikasi Android tunggal untuk keperluan ilustrasi. Dalam praktiknya Anda tidak boleh mendistribusikan kunci API sisi-server dalam aplikasi Android karena kunci Anda tidak bisa dijamin keamanannya dari akses tidak sah oleh pihak ketiga. Sebagai gantinya, untuk mengamankan kunci, Anda harus menggunakan kode API-facing sebagai proxy sisi-server dan atur agar aplikasi Android Anda mengirim permintaan melalui proxy, untuk memastikan permintaan telah diotorisasi.

Unduh

Unduh kode dari GitHub.

Kirim masukan tentang...

Google Maps Roads API
Google Maps Roads API
Butuh bantuan? Kunjungi halaman dukungan kami.