#include "google/maps/calls.h" #include #include "google/errors.h" #include "google/maps/caps.h" #include "google/resource.h" namespace molo::google::maps { // CALLS-BEGIN (parsed by tools/check_discovery.py; one row per line) static const CallSpec kCalls[] = { {Call::kPlacesAutocomplete, Api::kPlaces, "POST", "v1/places:autocomplete", "places.places.autocomplete", "input,sessionToken,locationBias,locationRestriction,includedPrimaryTypes,includedRegionCodes,languageCode,regionCode,origin,inputOffset,includeQueryPredictions", "fields", "discovery"}, {Call::kPlacesGet, Api::kPlaces, "GET", "v1/{+name}", "places.places.get", "", "languageCode,regionCode,sessionToken,fields", "discovery"}, {Call::kPlacesSearchNearby, Api::kPlaces, "POST", "v1/places:searchNearby", "places.places.searchNearby", "locationRestriction,includedTypes,excludedTypes,includedPrimaryTypes,excludedPrimaryTypes,maxResultCount,languageCode,regionCode,rankPreference", "fields", "discovery"}, {Call::kPlacesSearchText, Api::kPlaces, "POST", "v1/places:searchText", "places.places.searchText", "textQuery,includedType,strictTypeFiltering,openNow,minRating,priceLevels,locationBias,locationRestriction,pageSize,pageToken,languageCode,regionCode,rankPreference", "fields", "discovery"}, {Call::kPlacesPhotoMedia, Api::kPlaces, "GET", "v1/{+name}", "places.places.photos.getMedia", "", "maxHeightPx,maxWidthPx,skipHttpRedirect", "discovery"}, {Call::kAddressValidate, Api::kAddressValidation, "POST", "v1:validateAddress", "addressvalidation.validateAddress", "address,previousResponseId,enableUspsCass,languageOptions,sessionToken", "", "discovery"}, {Call::kAddressFeedback, Api::kAddressValidation, "POST", "v1:provideValidationFeedback", "addressvalidation.provideValidationFeedback", "conclusion,responseId", "", "discovery"}, {Call::kSolarBuildingInsights, Api::kSolar, "GET", "v1/buildingInsights:findClosest", "solar.buildingInsights.findClosest", "", "location.latitude,location.longitude,requiredQuality,exactQualityRequired", "discovery"}, {Call::kSolarDataLayers, Api::kSolar, "GET", "v1/dataLayers:get", "solar.dataLayers.get", "", "location.latitude,location.longitude,radiusMeters,view,requiredQuality,pixelSizeMeters,exactQualityRequired", "discovery"}, {Call::kSolarGeoTiff, Api::kSolar, "GET", "v1/geoTiff:get", "solar.geoTiff.get", "", "id", "discovery"}, {Call::kPollenForecast, Api::kPollen, "GET", "v1/forecast:lookup", "pollen.forecast.lookup", "", "location.latitude,location.longitude,days,languageCode,pageSize,pageToken,plantsDescription", "discovery"}, {Call::kPollenHeatmapTile, Api::kPollen, "GET", "v1/mapTypes/{mapType}/heatmapTiles/{zoom}/{x}/{y}", "pollen.mapTypes.heatmapTiles.lookupHeatmapTile", "", "", "discovery"}, {Call::kAirForecast, Api::kAirQuality, "POST", "v1/forecast:lookup", "airquality.forecast.lookup", "location,dateTime,period,pageSize,pageToken,universalAqi,extraComputations,uaqiColorPalette,customLocalAqis,languageCode", "", "discovery"}, {Call::kAirHeatmapTile, Api::kAirQuality, "GET", "v1/mapTypes/{mapType}/heatmapTiles/{zoom}/{x}/{y}", "airquality.mapTypes.heatmapTiles.lookupHeatmapTile", "", "", "discovery"}, {Call::kAirHistory, Api::kAirQuality, "POST", "v1/history:lookup", "airquality.history.lookup", "location,hours,period,dateTime,pageSize,pageToken,universalAqi,extraComputations,uaqiColorPalette,customLocalAqis,languageCode", "", "discovery"}, {Call::kAirCurrent, Api::kAirQuality, "POST", "v1/currentConditions:lookup", "airquality.currentConditions.lookup", "location,universalAqi,extraComputations,uaqiColorPalette,customLocalAqis,languageCode", "", "discovery"}, {Call::kAreaComputeInsights, Api::kAreaInsights, "POST", "v1:computeInsights", "areainsights.computeInsights", "insights,filter", "", "discovery"}, {Call::kRoutesCompute, Api::kRoutes, "POST", "directions/v2:computeRoutes", "ref:routes.computeRoutes", "origin,destination,intermediates,travelMode,routingPreference,polylineQuality,polylineEncoding,departureTime,arrivalTime,computeAlternativeRoutes,routeModifiers,languageCode,regionCode,units,optimizeWaypointOrder,requestedReferenceRoutes,extraComputations,trafficModel,transitPreferences", "fields", "reference"}, {Call::kRoutesMatrix, Api::kRoutes, "POST", "distanceMatrix/v2:computeRouteMatrix", "ref:routes.computeRouteMatrix", "origins,destinations,travelMode,routingPreference,departureTime,arrivalTime,languageCode,regionCode,units,extraComputations,trafficModel,transitPreferences", "fields", "reference"}, {Call::kGeocode, Api::kWebServices, "GET", "maps/api/geocode/json", "ref:geocoding.json", "", "address,components,bounds,language,region,latlng,place_id,result_type,location_type", "reference"}, {Call::kTimeZone, Api::kWebServices, "GET", "maps/api/timezone/json", "ref:timezone.json", "", "location,timestamp,language", "reference"}, {Call::kElevation, Api::kWebServices, "GET", "maps/api/elevation/json", "ref:elevation.json", "", "locations,path,samples", "reference"}, {Call::kStreetPhotoSequences, Api::kStreetViewPublish, "GET", "v1/photoSequences", "streetviewpublish.photoSequences.list", "", "filter,pageSize,pageToken", "discovery"}, {Call::kStreetPhotoStartUpload, Api::kStreetViewPublish, "POST", "v1/photo:startUpload", "streetviewpublish.photo.startUpload", "", "", "discovery"}, {Call::kStreetPhotoGet, Api::kStreetViewPublish, "GET", "v1/photo/{photoId}", "streetviewpublish.photo.get", "", "view,languageCode", "discovery"}, {Call::kStreetPhotoCreate, Api::kStreetViewPublish, "POST", "v1/photo", "streetviewpublish.photo.create", "uploadReference,pose,captureTime,places,connections", "", "discovery"}, {Call::kStreetPhotoUpdate, Api::kStreetViewPublish, "PUT", "v1/photo/{id}", "streetviewpublish.photo.update", "photoId,pose,captureTime,places,connections", "updateMask", "discovery"}, {Call::kStreetPhotoDelete, Api::kStreetViewPublish, "DELETE", "v1/photo/{photoId}", "streetviewpublish.photo.delete", "", "", "discovery"}, {Call::kStreetSequenceGet, Api::kStreetViewPublish, "GET", "v1/photoSequence/{sequenceId}", "streetviewpublish.photoSequence.get", "", "view,filter", "discovery"}, {Call::kStreetSequenceDelete, Api::kStreetViewPublish, "DELETE", "v1/photoSequence/{sequenceId}", "streetviewpublish.photoSequence.delete", "", "", "discovery"}, {Call::kStreetSequenceCreate, Api::kStreetViewPublish, "POST", "v1/photoSequence", "streetviewpublish.photoSequence.create", "uploadReference,captureTimeOverride,filename", "inputType", "discovery"}, {Call::kStreetSequenceStartUpload, Api::kStreetViewPublish, "POST", "v1/photoSequence:startUpload", "streetviewpublish.photoSequence.startUpload", "", "", "discovery"}, {Call::kStreetPhotosBatchUpdate, Api::kStreetViewPublish, "POST", "v1/photos:batchUpdate", "streetviewpublish.photos.batchUpdate", "updatePhotoRequests", "", "discovery"}, {Call::kStreetPhotosBatchDelete, Api::kStreetViewPublish, "POST", "v1/photos:batchDelete", "streetviewpublish.photos.batchDelete", "photoIds", "", "discovery"}, {Call::kStreetPhotosList, Api::kStreetViewPublish, "GET", "v1/photos", "streetviewpublish.photos.list", "", "view,filter,pageSize,pageToken,languageCode", "discovery"}, {Call::kStreetPhotosBatchGet, Api::kStreetViewPublish, "GET", "v1/photos:batchGet", "streetviewpublish.photos.batchGet", "", "photoIds,view,languageCode", "discovery"}, {Call::kApiKeysList, Api::kApiKeys, "GET", "v2/{+parent}/keys", "apikeys.projects.locations.keys.list", "", "pageSize,pageToken,showDeleted", "discovery"}, {Call::kApiKeysGet, Api::kApiKeys, "GET", "v2/{+name}", "apikeys.projects.locations.keys.get", "", "", "discovery"}, }; // CALLS-END const CallSpec& spec_of(Call call) { for (const auto& s : kCalls) if (s.call == call) return s; throw GoogleError::invalid("unknown call"); } clients::Method method_of(Call call) { const char* m = spec_of(call).http_method; if (!std::strcmp(m, "GET")) return clients::Method::kGet; if (!std::strcmp(m, "POST")) return clients::Method::kPost; if (!std::strcmp(m, "PUT")) return clients::Method::kPut; if (!std::strcmp(m, "DELETE")) return clients::Method::kDelete; throw GoogleError::invalid("unknown http method"); } std::size_t call_count() { return sizeof(kCalls) / sizeof(kCalls[0]); } const CallSpec& spec_at(std::size_t index) { if (index >= call_count()) throw GoogleError::invalid("call index out of range"); return kCalls[index]; } ServiceEndpoint endpoint_of(Api api) { switch (api) { case Api::kPlaces: return {"places", "https://places.googleapis.com", true}; case Api::kAddressValidation: return {"addressvalidation", "https://addressvalidation.googleapis.com", true}; case Api::kSolar: return {"solar", "https://solar.googleapis.com", true}; case Api::kPollen: return {"pollen", "https://pollen.googleapis.com", true}; case Api::kAirQuality: return {"airquality", "https://airquality.googleapis.com", true}; case Api::kAreaInsights: return {"areainsights", "https://areainsights.googleapis.com", true}; case Api::kRoutes: return {"routes", "https://routes.googleapis.com", true}; case Api::kWebServices: return {"maps", "https://maps.googleapis.com", true}; case Api::kStreetViewPublish: return {"streetviewpublish", "https://streetviewpublish.googleapis.com", false}; case Api::kApiKeys: return {"apikeys", "https://apikeys.googleapis.com", false}; } throw GoogleError::invalid("unknown api"); } bool in_list(const char* list, const std::string& name) { std::string cur; for (const char* p = list;; ++p) { if (*p == ',' || *p == '\0') { if (cur == name) return true; cur.clear(); if (*p == '\0') return false; } else { cur += *p; } } } namespace { // Photo references are longer than valid_segment's 128; same alphabet. bool long_segment(const std::string& id) { if (id.empty() || id.size() > 512 || id == "." || id == "..") return false; for (char c : id) if (!((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || (c >= '0' && c <= '9') || c == '-' || c == '_' || c == '.')) return false; return true; } bool valid_path_segment(const std::string& s, bool plus) { if (!plus) return valid_segment(s); // A resource name: "places/ChIJ..", "projects/p/locations/global/keys/k". if (s.empty() || s.size() > 512) return false; std::size_t start = 0; while (true) { std::size_t slash = s.find('/', start); std::string part = s.substr(start, slash == std::string::npos ? std::string::npos : slash - start); if (!long_segment(part)) return false; if (slash == std::string::npos) return true; start = slash + 1; } } } // namespace std::string render(Call call, const std::map& vars) { std::string out = "/"; const std::string path = spec_of(call).path; std::size_t used = 0; for (std::size_t i = 0; i < path.size();) { if (path[i] != '{') { out += path[i++]; continue; } std::size_t close = path.find('}', i); std::string name = path.substr(i + 1, close - i - 1); bool plus = !name.empty() && name[0] == '+'; if (plus) name = name.substr(1); auto it = vars.find(name); if (it == vars.end()) throw GoogleError::invalid("missing path variable " + name); if (!valid_path_segment(it->second, plus)) throw GoogleError::invalid("bad value for path variable " + name); out += it->second; ++used; i = close + 1; } if (used != vars.size()) throw GoogleError::invalid("unexpected path variable"); if (out.size() > MapsCaps::kMaxPathChars) throw GoogleError::invalid("path too long"); return out; } } // namespace molo::google::maps