Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Obsługa błędów

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Po przesłaniu prośby możesz otrzymać odpowiedź zawierającą szczegóły błędu.

Kafelki 2D i zdjęcia Street View

Poniżej znajdziesz listę błędów, które możesz napotkać podczas korzystania z płytków 2D i zdjęć Street View.

Lista błędów

Poniżej znajdziesz listę błędów, które możesz napotkać podczas korzystania z Map Tiles API.

required

W Twojej prośbie brakuje parametru adresu URL. Pamiętaj, że komunikat o błędzie wskazuje, którego parametru brakuje.

notFound, invalid

Wartości x, y lub z są spoza zakresu.

W przypadku zwykłych kafelków mapy maksymalny poziom powiększenia zależy od konkretnego kafelka mapy i od opcji mapy, o które prosisz.
W przypadku zwykłych kafelków mapy współrzędna x musi mieścić się w zakresie [0, (2^zoom)-1].
W przypadku zwykłych kafelków mapy współrzędna y musi mieścić się w zakresie [0, (2^(zoom-1))-1].
W przypadku kafelków Street View poziom powiększenia musi mieścić się w zakresie od 0 do 5 włącznie.
W przypadku kafelków Street View zakresy współrzędnych x i y są takie same jak w przypadku zwykłych kafelków mapy aż do poziomu powiększenia 5. W tym momencie maksymalne wartości to imageHeight lub imagewidth podzielone przez tileHeight lub tileWidth.

forbidden:

Możliwe przyczyny:

W żądaniu brakuje prawidłowego klucza interfejsu API.
Wiadomość: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

Kafelki satelitarne 2D nie są dostępne w projektach połączonych z kontem rozliczeniowym z adresem w Europejskim Obszarze Gospodarczym (EOG). Więcej informacji znajdziesz w artykule Zmiany w interfejsie Map Tiles API dla klientów z Europejskiego Obszaru Gospodarczego.

expired

Token session stracił ważność. Token sesji jest ważny przez 2 tygodnie od momentu utworzenia. Pamiętaj, że może się to zmienić bez powiadomienia. Jeśli pojawi się ten błąd, musisz uzyskać nowy token sesji zgodnie z opisem w sekcji Używanie tokenów sesji.

badRequest

Żądanie było nieprawidłowo sformatowane. Oto częste powody:

Określono typ mapy terrain bez uwzględnienia warstwy roadmap.
W przypadku typu mapy innego niż mapa drogowa uwzględniono tablicę styles.
W żądaniu metadanych Street View przesłano wartość szerokości i długości geograficznej oraz identyfikator panoramy.

quotaExceeded, rateLimitExceeded

Aplikacja przekroczyła dozwolony limit lub dozwoloną liczbę zapytań na sekundę.

Przykładowy błąd

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

Ponawianie żądań

Gdy żądania kończą się niepowodzeniem z kodami quotaExceeded i rateLimitExceeded, należy ponowić żądanie w taki sposób, aby uszkodzone żądania lub awarie na dużą skalę nie zalewały serwerów Google, ponieważ wielu klientów próbuje ponawiać żądania w szybkiej kolejności. Oznacza to, że podczas ponawiania żądań należy stosować wzrastający czas do ponowienia. Wzrastający czas do ponowienia zmusza Cię do rozłożenia żądań w czasie, aby serwer miał czas na odzyskanie sprawności.

Jeśli np. żądanie się nie powiedzie, spróbuj ponownie po sekundzie. Jeśli ta próba również się nie powiedzie, spróbuj ponownie po 2 sekundach. Jeśli to żądanie również się nie powiedzie, spróbuj ponownie po 4 sekundach. W ten sposób skutecznie rozkładasz kolejne żądania, po prostu podwajając odstęp czasu między nimi.

Kafelki 3D

Błędy serwera Google mogą być dla Ciebie niewidoczne, ponieważ dostęp do fotorealistycznych kafelków uzyskujesz za pomocą renderera, który odpowiada za obsługę błędów serwera.

Błędy renderowania kafelków

Na przykład moduł renderujący CesiumJS zwykle nie zgłasza błędów serwera, co może powodować awarie, puste ekrany lub brak wczytywania konkretnych kafelków.

Technika debugowania błędów serwera zależy od konkretnego renderera, którego używasz. W przypadku rendererów opartych na przeglądarce, takich jak CesiumJS, możesz sprawdzić ruch w sieci za pomocą narzędzi wbudowanych w większość przeglądarek. Możesz na przykład użyć Narzędzi deweloperskich w Chrome.

Typowe błędy

Poniżej znajdziesz szczegółowe informacje o najczęstszych błędach, które możesz napotkać.

400. Nieprawidłowy argument: Nieprawidłowe klucze interfejsu API, parametry zapytania, identyfikatory kafelków lub zestawów kafelków albo wygasły token sesji.
400. Nieprawidłowa wartość: Upewnij się, że createSessionTokenmapType, z którego wysłano żądanie, jest zgodny z parametrem mapType używanym w kolejnym punkcie końcowym kafelka. Na przykład tokena sesji streetview nie można użyć do wysłania żądania dotyczącego kafelka roadmap.

403. Odmowa dostępu