Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Obsługa błędów

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Po wysłaniu żądania 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 mogą wystąpić podczas korzystania z kafelków 2D i zdjęć Street View.

Lista błędów

Poniżej znajdziesz listę błędów, które mogą wystąpić podczas korzystania z interfejsu Map Tiles API.

required

W Twoim żądaniu 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ą poza zakresem.

W przypadku zwykłych kafelków mapy maksymalny poziom powiększenia zależy od konkretnego kafelka mapy i 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 powiązanych z kontem rozliczeniowym z adresem w Europejskim Obszarze Gospodarczym (EOG). Więcej informacji znajdziesz w artykule Dostosowania interfejsu Map Tiles API dla klientów z EOG .

expired

Twój token session wygasł. Token sesji jest ważny przez 2 tygodnie od daty jego utworzenia. Pamiętaj, że może się to zmienić bez powiadomienia. Jeśli otrzymasz ten błąd, musisz uzyskać nowy token sesji zgodnie z opisem w artykule Używanie tokenów sesji.

badRequest

Twoje żądanie było nieprawidłowe. Oto częste powody:

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

quotaExceeded, rateLimitExceeded

Twoja 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 powodu błędów quotaExceeded i rateLimitExceeded, należy ponowić żądanie w taki sposób, aby uszkodzone żądania lub awarie na dużą skalę nie przeciążały serwerów Google. Wielu klientów próbuje ponowić żądania w krótkich odstępach czasu. Oznacza to, że podczas ponawiania żądań należy stosować wzrastający czas do ponowienia. Wzrastający czas do ponowienia wymusza rozłożenie żądań w czasie, aby serwer miał czas na odzyskanie sprawności.

Jeśli na przykład żą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 też się nie powiedzie, spróbuj ponownie po 4 sekundach. W ten sposób skutecznie rozkładasz każde kolejne żądanie, 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 renderera kafelków

Na przykład renderer CesiumJS zwykle nie zgłasza błędów serwera, co może powodować awarie, puste ekrany lub brak wczytywania określonych kafelków.

Technika debugowania błędów serwera zależy od używanego renderera. W przypadku mechanizmów renderowania 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 mogą wystąpić.

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 wartość mapType, z którą zostało wysłane żądanie createSessionToken, jest zgodna z wartością mapType używaną w kolejnym punkcie końcowym kafelka. Na przykład tokena sesji streetview nie można użyć do żądania kafelka roadmap.

403: odmowa dostępu