TypeScript i Mapy Google

TypeScript to nadrzędny kod JavaScript, który kompiluje się do zwykłego kodu JavaScript. Fragment kodu poniżej pokazuje, jak można łatwo korzystać z Map Google przy użyciu TypeScriptu.

let map: google.maps.Map;
const center: google.maps.LatLngLiteral = {lat: 30, lng: -110};

function initMap(): void {
  map = new google.maps.Map(document.getElementById("map") as HTMLElement, {
    center,
    zoom: 8
  });
}

Pierwsze kroki

Projekt DefinitelyTyped to projekt typu open source, który obsługuje pliki deklaracji typu wielu pakietów, w tym Mapy Google. Pliki deklaracji JavaScriptu Map Google (zobacz pliki źródłowe w GitHubie) możesz zainstalować za pomocą narzędzia NPM z pakietu @types/google.maps.

npm i -D @types/google.maps

Funkcje alfa i beta

Typy zwykle nie mają właściwości, funkcji ani klas występujących w wersjach alfa lub beta. W wielu przypadkach obiekt można przesłać na prawidłowy typ.

Przyczyną tego błędu jest właściwość mapId w wersji beta aplikacji MapOptions.

error TS2345: Argument of type '{ center: google.maps.LatLng; zoom: number;
mapId: string; }' is not assignable to parameter of type 'MapOptions'. Object
literal may only specify known properties, and 'mapId' does not exist in type
'MapOptions'.

Powyższy błąd można poprawić, korzystając z przesyłanego poniżej obrazu.

{ center: {lat: 30, lng: -110}, zoom: 8, mapId: '1234' } as google.maps.MapOptions

Sprzeczne pakiety @types

Niektóre biblioteki mogą używać pakietu innego niż @types/google.maps, co może powodować konflikty. Aby uniknąć problemów z niespójnymi typami, użyj opcji kompilacji skipLibCheck.

{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

Określanie typu głównego

Niektóre platformy, takie jak Angular, mogą wymagać określenia opcji kompilatora typeRoots, aby uwzględnić typy zainstalowane z @types/google.maps i wszystkich innych pakietów „@types”.

{
    ...
    "compilerOptions": {
        ...
        "typeRoots": [
            "node_modules/@types",
        ],
        ...
    }
}