Pozyskiwanie danych
Zebrane dane o lokalizacji można uzyskać na wiele sposobów. Poniżej opisujemy 2 metody pozyskiwania danych, które możesz zastosować w funkcji przyciągaj do dróg w obiekcie Roads API.
GPX
GPX to otwarty format XML służący do udostępniania tras, ścieżek i punktów zapisanych przez urządzenia GPS. W tym przykładzie używamy parsera XmlPull, czyli lekkiego parsera XML, który jest dostępny zarówno dla serwera Java, jak i środowisk mobilnych.
/**
* 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;
}
Oto nieprzetworzone dane GPX wczytane na mapę.
Usługi lokalizacyjne w Androidzie
Najlepszy sposób rejestrowania danych GPS na urządzeniach z Androidem zależy od konkretnego przypadku użycia. Zapoznaj się z zajęciami szkoleniowymi na temat Androida w sekcji Odbieranie aktualizacji lokalizacji oraz przykładami lokalizacji Google Play na GitHubie.
Długie ścieżki przetwarzania
Funkcja przyciąganie do dróg określa lokalizację na podstawie pełnej ścieżki, a nie poszczególnych punktów, dlatego podczas przetwarzania długich ścieżek (czyli ścieżek przekraczających limit 100 punktów na żądanie) musisz zachować ostrożność.
Aby poszczególne żądania były traktowane jako 1 długa ścieżka, należy uwzględnić część nakładających się żądań, tak aby punkty końcowe z poprzedniego żądania były uwzględnione jako pierwsze punkty w kolejnym. Liczba punktów do uwzględnienia zależy od dokładności danych. Należy podać więcej punktów w przypadku żądań o niskiej dokładności.
W tym przykładzie używamy klienta Java dla usług Map Google do wysyłania żądań stron, a następnie ponownie łączy dane, w tym punkty interpolowane, w zwracaną listę.
/**
* 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;
}
Oto powyższe dane po uruchomieniu funkcji przyciągania do dróg. Czerwona linia to nieprzetworzone dane, a niebieska – dane przyciągnięte.
Efektywne wykorzystanie limitu
Odpowiedź na żądanie przyciągnięcia do dróg zawiera listę identyfikatorów miejsc zmapowanych na podane przez Ciebie punkty, a może z dodatkowymi punktami, jeśli ustawisz wartość interpolate=true.
Aby skutecznie wykorzystać dozwolony limit w przypadku prośby o ograniczenie prędkości, wysyłaj w prośbie tylko unikalne identyfikatory miejsc. W tym przykładzie używamy klienta Java dla usług Map Google do wysyłania zapytań o ograniczenia szybkości na podstawie listy identyfikatorów miejsc.
/**
* 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;
}
Oto powyższe dane z ograniczeniami prędkości oznaczonymi przy każdym unikalnym identyfikatorze miejsca.
Współpraca z innymi interfejsami API
Jedną z zalet zwracania identyfikatorów miejsc w odpowiedziach przyciągaj do dróg jest możliwość używania identyfikatora miejsca w wielu interfejsach API Google Maps Platform. W tym przykładzie używamy klienta Java dla usług Map Google do geokodowania miejsca zwróconego w odpowiedzi na żądanie dotyczące drogi.
/**
* 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;
}
W tym miejscu znacznik ograniczenia prędkości został oznaczony adresem z interfejsu Geocoding API.
Przykładowy kod
co należy wziąć pod uwagę
W celach ilustracyjnych kod służący do obsługi tego artykułu jest dostępny jako pojedyncza aplikacja na Androida. W praktyce nie należy rozpowszechniać kluczy interfejsu API po stronie serwera w aplikacji na Androida, ponieważ taki klucz nie jest zabezpieczony przed nieuprawnionym dostępem z zewnątrz. Zamiast tego, aby zabezpieczyć klucze, wdróż kod interfejsu API jako serwer proxy po stronie serwera. Aplikacja na Androida będzie wysyłać żądania przez serwer proxy, co zapewni ich autoryzację.
Pobieranie
Pobierz kod z GitHub.