Omówienie interfejsu Map Management API

Interfejs Map Management API to interfejs RESTful, którego możesz używać do programowego zarządzania zasobami definiowania stylów map w Google Cloud. Ten interfejs API umożliwia definiowanie wyglądu map, zarządzanie ich tożsamościami oraz powiązywanie niestandardowych stylów i zbiorów danych z określonymi wariantami mapy – wszystko to bez używania konsoli Cloud.

Interfejs Map Management API jest przeznaczony dla deweloperów, którzy chcą zarządzać konfiguracjami map na dużą skalę lub integrować stylizację map z własnymi zautomatyzowanymi przepływami pracy i narzędziami wewnętrznymi.

Przydatne zasoby

  • StyleConfig: zawiera reprezentację stylu mapy w formacie JSON. Określa kolory, widoczność i gęstość elementów mapy.
  • MapConfig: reprezentuje unikalną tożsamość mapy (identyfikator mapy). Pełni funkcję kontenera ustawień stylu i funkcji takich jak wzmacnianie ważnych miejsc czy spłaszczanie budynków.
  • MapContextConfig: łączy StyleConfig (i opcjonalnie co najmniej 1 zbiór danych) z określonymi MapVariants w ramach MapConfig.

Kanały wersji interfejsu API

Interfejs Map Management API używa wersji opartych na kanałach, aby zapewnić jasną ścieżkę od funkcji eksperymentalnych do stabilnych, ogólnodostępnych.

  • v2alpha (eksperymentalna): zawiera najnowsze funkcje eksperymentalne. Funkcje w tym kanale mogą ulec zmianie bez powiadomienia i nie są zalecane do użytku w środowisku produkcyjnym.
  • v2beta (wersja testowa): zawiera funkcje, które są stabilne i przygotowywane do ogólnej dostępności. Ten kanał jest odpowiedni do wczesnego wdrażania i testowania w środowiskach przedprodukcyjnych.
  • v2 (ogólna dostępność): zawiera w pełni obsługiwane funkcje gotowe do wdrożenia w środowisku produkcyjnym.

Większość funkcji wersji 2 jest dostępna w przypadku punktów końcowych v2alpha i v2beta w odpowiednich fazach wdrażania. Nowym użytkownikom Google zaleca rozpoczęcie od punktu końcowego v2beta.

Uwierzytelnianie

Do uwierzytelniania w interfejsie Map Management API możesz używać tylko protokołu OAuth 2.0, który nie obsługuje kluczy interfejsu API. Więcej informacji znajdziesz w artykule Korzystanie z OAuth.

Ograniczenia

  • Role dewelopera: aby korzystać z interfejsu Map Management API, musisz mieć odpowiednie uprawnienia IAM do zarządzania zasobami Google Maps Platform w projekcie Google Cloud.
  • Zakres zasobów: ten interfejs API służy do zarządzania zasobami stylów map w chmurze. Inne konfiguracje Google Maps Platform mogą nadal wymagać konsoli Cloud.

Koszty

Korzystanie z interfejsu API zarządzania mapami jest bezpłatne. Wywołania interfejsu API są widoczne na stronie Płatności w konsoli Cloud, ale opłaty wynoszą 0 USD. Żądania są jednak ograniczone w ten sposób:

  • 3 QPS (zapytania na sekundę)
  • 180 zapytań na minutę w przypadku projektu, odświeżanych co minutę
  • 100 000 zapytań dziennie na projekt, odświeżane każdego dnia

Zobacz Wykorzystanie i płatności.