Określ lokalizacje na trasie

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Aby obliczyć trasę, musisz podać co najmniej lokalizację początku i końca trasy. Te lokalizacje definiujesz jako punkty pośrednie na trasie.

Oprócz punktu początkowego i docelowego możesz określić różne typy punktów pośrednich i sposób ich obsługi na trasie. Więcej informacji i przykładów znajdziesz w tych artykułach:

Określanie lokalizacji na trasie

Lokalizację reprezentujesz, tworząc obiekt Waypoint (REST) lub Waypoint (gRPC). W definicji punktu pośredniego możesz określić lokalizację na jeden z tych sposobów:

Lokalizacje wszystkich punktów pośrednich w żądaniu możesz określić w ten sam sposób lub je wymieszać. Możesz na przykład użyć współrzędnych geograficznych dla punktu początkowego i identyfikatora miejsca dla punktu docelowego.

Aby zwiększyć wydajność i dokładność, używaj identyfikatorów miejsc zamiast współrzędnych geograficznych lub ciągów znaków adresu. Identyfikatory miejsc są jednoznaczne i zapewniają korzyści związane z geokodowaniem na potrzeby wyznaczania tras, takie jak punkty dostępu i zmienne dotyczące ruchu. Pomagają one uniknąć tych sytuacji, które mogą wystąpić w przypadku innych sposobów określania lokalizacji:

  • Korzystanie ze współrzędnych geograficznych może spowodować, że lokalizacja zostanie przypisana do najbliższej drogi, która może nie być punktem dostępu do obiektu ani nawet drogą, która szybko i bezpiecznie prowadzi do celu.
  • Przed obliczeniem trasy ciągi adresów muszą zostać najpierw przekształcone na współrzędne długości i szerokości geograficznej za pomocą interfejsu Routes API. Ta konwersja może wpłynąć na skuteczność.

Określanie lokalizacji za pomocą identyfikatora miejsca

Aby określić lokalizację punktu pośredniego, możesz użyć identyfikatora miejsca. Współrzędne geograficzne są dopasowywane do dróg, więc w niektórych przypadkach identyfikator miejsca może dawać lepsze wyniki.

Pobieraj identyfikatory miejsc z Geocoding API i Places API (w tym z funkcji autouzupełniania miejsc). Więcej informacji o identyfikatorach miejsc znajdziesz w tym artykule.

W tym przykładzie właściwość placeId służy do przekazywania identyfikatora miejsca zarówno w przypadku origin, jak i destination:

{
  "origin":{
    "placeId": "ChIJayOTViHY5okRRoq2kGnGg8o"
  },
  "destination":{
    "placeId": "ChIJTYKK2G3X5okRgP7BZvPQ2FU"
  },
  ...
}

Określanie lokalizacji za pomocą współrzędnych geograficznych

Aby zdefiniować lokalizację w punkcie pośrednim, określ Lokalizację (REST) lub Lokalizację(gRPC), używając współrzędnych geograficznych.

Możesz na przykład określić punkt pośredni na trasie origin i destination za pomocą współrzędnych latitude i longitude:

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
...
}

Określanie lokalizacji jako ciągu znaków adresu

Ciągi adresów to dosłowne adresy reprezentowane przez ciąg znaków (np. „1600 Amphitheatre Parkway, Mountain View, CA”). Geokodowanie to proces konwertowania ciągu znaków adresu na współrzędne szerokości i długości geograficznej (np. szerokość geograficzna 37.423021 i długość geograficzna -122.083739).

Gdy przekazujesz ciąg znaków adresu jako lokalizację punktu pośredniego, interfejs Routes API wewnętrznie geokoduje ciąg znaków, aby przekonwertować go na współrzędne geograficzne.

Aby na przykład obliczyć trasę, musisz podać punkt pośredni origin i destination za pomocą ciągów znaków adresu:

{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "450 Serra Mall, Stanford, CA 94305, USA"
  },
  ...
}

W tym przykładzie interfejs Routes API geokoduje oba adresy, aby przekształcić je we współrzędne długości i szerokości geograficznej.

Jeśli wartość adresu jest niejednoznaczna, interfejs Routes API może wywołać wyszukiwanie, aby odróżnić go od podobnych adresów. Na przykład „1st Street” może być pełną lub częściową wartością dla „1st street NE” lub „1st St SE”. Ten wynik może się różnić od wyniku zwracanego przez interfejs Geocoding API. Aby uniknąć możliwych błędnych interpretacji, możesz używać identyfikatorów miejsc.

Ustawianie regionu adresu

Jeśli jako lokalizację punktu pośredniego podasz niepełny ciąg znaków adresu, interfejs API może użyć nieprawidłowych współrzędnych geograficznych. Na przykład wysyłasz żądanie, w którym jako miejsce docelowe podajesz „Toledo”, a jako miejsce docelowe „Madryt” w przypadku trasy przejazdu samochodem:

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE"
}

W tym przykładzie „Toledo” jest interpretowane jako miasto w stanie Ohio w Stanach Zjednoczonych, a nie w Hiszpanii. Dlatego żądanie zwraca pustą tablicę, co oznacza, że nie ma żadnych tras:

{
  []
}

Możesz skonfigurować interfejs API tak, aby zwracał wyniki z określonego regionu, uwzględniając parametr regionCode. Ten parametr określa kod regionu jako dwuznakową wartość ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma znaczącymi wyjątkami. Na przykład krajowa domena najwyższego poziomu Zjednoczonego Królestwa to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”).

Żądanie wskazówek dojazdu z „Toledo” do „Madrytu” zawierające parametr regionCode zwraca odpowiednie wyniki, ponieważ „Toledo” jest interpretowane jako miasto w Hiszpanii:

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE",
  "regionCode": "es"
}

Odpowiedź zawiera teraz trasę obliczoną z Toledo w Hiszpanii do Madrytu w Hiszpanii:

{
  "routes": [
    {
      "distanceMeters": 75330,
      "duration": "4137s",
      ...
    }
  ]
}

Określanie lokalizacji za pomocą kodu Plus Code

Wiele osób nie ma dokładnego adresu, co może utrudniać im odbiór przesyłek. Osoby z adresem mogą też woleć odbierać przesyłki w bardziej konkretnych miejscach, np. przy tylnym wejściu lub na rampie załadunkowej.

Kody Plus Code działają jak adresy dla osób lub miejsc, które nie mają rzeczywistego adresu. Kody plus nie są adresami z nazwami ulic i numerami, ale opierają się na współrzędnych długości i szerokości geograficznej i wyświetlają się jako liczby i litery.

Google opracowało kody Plus Code, aby każdy mógł korzystać z zalet adresów. Kod plus to zakodowany odniesienie do lokalizacji, które jest wyznaczane na podstawie współrzędnych geograficznych (długości i szerokości geograficznej) i reprezentuje obszar o wielkości 1/8000 stopnia na 1/8000 stopnia (około 14 m x 14 m na równiku) lub mniejszy. Kodów Plus Code możesz używać zamiast adresów w miejscach, w których nie istnieją lub w których budynki nie są ponumerowane albo ulice nie mają nazw.

Kody Plus Code muszą być sformatowane jako kod globalny lub kod złożony:

  • Kod globalny składa się z 4-znakowego kodu obszaru i 6-znakowego lub dłuższego kodu lokalnego.

    Na przykład dla adresu „1600 Amphitheatre Parkway, Mountain View, CA” kod globalny to „849V”, a kod lokalny to „CWC8+R9”. Następnie użyj całego 10-znakowego kodu plus, aby określić wartość lokalizacji jako „849VCWC8+R9”.

  • Kod złożony składa się z co najmniej 6-znakowego kodu lokalnego połączonego z określoną lokalizacją.

    Na przykład adres „450 Serra Mall, Stanford, CA 94305, USA” ma kod lokalny „CRHJ+C3”. W przypadku adresu złożonego połącz kod lokalny z miastem, stanem, kodem pocztowym i krajem w formacie „CRHJ+C3 Stanford, CA 94305, USA”.

    Możesz na przykład obliczyć trasę, podając punkt pośredni origin i destination za pomocą kodów plus:

    {
  "origin":{
    "address": "849VCWC8+R9"
  },
  "destination":{
    "address": "CRHJ+C3 Stanford, CA 94305, USA"
  },
  "travelMode": "DRIVE"
}

Kody Plus są obsługiwane w interfejsach Google Maps Platform API, w tym w Autouzupełnianiu miejsc, Szczegółach miejsca, interfejsie Directions API (starsza wersja) i interfejsie Geocoding API. Możesz na przykład użyć interfejsu Geocoding API do geokodowania odwrotnego lokalizacji określonej przez współrzędne geograficzne, aby określić kod Plus Code tej lokalizacji.